Skip to content

GitLab Pages

With GitLab Pages you can host your website at no cost.

Your files live in a GitLab project's repository, from which you can deploy static websites. GitLab Pages supports all static site generators (SSGs).

Getting Started

Follow the steps below to get your website live. They shouldn't take more than 5 minutes to complete:

  • 1. Fork an example project
  • 2. Change a file to trigger a GitLab CI/CD pipeline
  • 3. Visit your project's Settings > Pages to see your website link, and click on it. Bam! Your website is live.

Further steps (optional):

  • 4. Remove the fork relationship (You don't need the relationship unless you intent to contribute back to the example project you forked from).
  • 5. Make it a user/group website

Watch a video with the steps above: https://www.youtube.com/watch?v=TWqh9MtT4Bg

Advanced options:

Explore GitLab Pages

With GitLab Pages you can create static websites for your GitLab projects, groups, or user accounts. You can use any static website generator: Jekyll, Middleman, Hexo, Hugo, Pelican, you name it! Connect as many custom domains as you like and bring your own TLS certificate to secure them.

Read the following tutorials to know more about:

Blog posts series about Static Site Generators (SSGs):

Blog posts for securing GitLab Pages custom domains with SSL/TLS certificates:

Advanced use

Admin GitLab Pages for CE and EE

Enable and configure GitLab Pages on your own instance (GitLab Community Edition and Enterprise Editions) with the admin guide.

Watch the video: https://www.youtube.com/watch?v=dD8c7WNcc6s

More information about GitLab Pages