Gitlab Pages

Tue Apr 5, 2016

Gitlab Pages

Need to add some content here? Although gitlab blog recently in June 2016 also has a series on static websites and gitlab pages.

The web page has good directions on how to setup gitlab pages.

This is also interesting: Hugo Tutorial on Gitlab Pages with Gitlab CI

(Optional) Follow steps listed here

If you skip this step, your website will be available at, where username your username on GitLab and projectname the name of the project you forked in the first step. This is what we call a project Page.

GitLab User or Group Pages
To use this project as your user/group website, you will need one additional step: just rename your project to, where namespace is your username or groupname. This can be done by navigating to your project's Settings.
You'll need to configure your site too: change this line in your config.toml, from "" to baseurl = "". Proceed equaly if you are using a custom domain: baseurl = "http(s)://".
Read more about user/group Pages and project Pages.

How to set up GitLab Pages in a repository where there’s also actual code

Remember that GitLab Pages are by default branch/tag agnostic and their deployment relies solely on what you specify in .gitlab-ci.yml. You can limit the pages job with the only parameter, whenever a new commit is pushed to a branch that will be used specifically for your pages.

That way, you can have your project’s code in the master branch and use an orphan branch (let’s name it pages) that will host your static generator site.

You can create a new empty branch like this:

git checkout --orphan pages

The first commit made on this new branch will have no parents and it will be the root of a new history totally disconnected from all the other branches and commits. Push the source files of your static generator in the pages branch.

Below is a copy of .gitlab-ci.yml where the most significant line is the last one, specifying to execute everything in the pages branch:

image: ruby:2.1

  - gem install jekyll
  - jekyll build -d public/
    - public
  - pages