Skip to content
Hyas Docs Hyas Docs Hyas Docs

Deploy your Hyas Site to GitLab Pages

You can use GitLab Pages to host a Hyas site for your GitLab projects, groups, or user account.

How to deploy

Follow the instructions below to deploy your Hyas site to GitLab pages.

  1. Create a file called .gitlab-ci.yml in the root of your project with the content below. This will build and deploy your site whenever you make changes to your content:

    .gitlab-ci.yml
    # The Docker image that will be used to build your app
    image: node:lts
    # Functions that should be executed before the build script is run
    before_script:
      - npm ci
    pages:
      script:
        - npm run build
      artifacts:
        paths:
          # The folder that contains the files to be exposed at the Page URL
          - public
      rules:
        # This ensures that only pushes to the default branch will trigger
        # a pages deploy
        - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

  2. On GitLab, go to your repository’s Deploy tab and find the Pages section.

  3. Copy the Access pages URL and paste it as baseurl in ./config/production/hugo.toml.

  4. Set canonifyURLs = true in ./config/production/hugo.toml.

  5. Push the changes to GitLab.

That’s it. After a minute or so, you site is avaliable at the Access pages URL.

More Deployment Guides