Create a GitLab Pages deployment for a static site (FREE ALL)
If you already have a GitLab project that contains your static site or framework, you can generate a GitLab Pages website from it.
When you provide basic information in the UI, a
.gitlab-ci.yml file is created
and a merge request opened. When you commit the merge request,
a pipeline deploys your Pages website.
Your app must output files to the
publicfolder. If you create this folder during the build pipeline, you do not need to commit it to Git.
WARNING: This step is important. Ensure your files are in a root-level
You must have a project that either:
GitLab Pages must be enabled for the project. (To enable, go to Settings > General, expand Visibility, project features, permissions, and turn on the Pages toggle.)
Create the Pages deployment
To complete the setup and generate a GitLab Pages deployment:
On the left sidebar, select Search or go to and find your project.
On the left sidebar, select Deploy > Pages.
A Get Started with Pages form appears. If this form is not available, see Troubleshooting.
For Step 1, enter an image name and verify that your files are in a
For Step 2, enter your installation steps. If your framework's build process does not need one of the provided build commands, you can either:
- Skip the step by selecting Next.
:(the bash "do nothing" command) if you still want to incorporate that step's boilerplate into your
For Step 3, enter scripts that indicate how to build your application.
Optional. Edit the generated
.gitlab-ci.ymlfile as needed.
For Step 4, add a commit message and select Commit. This commit triggers your first GitLab Pages deployment.
To view the running pipeline, go to Build > Pipelines.
To view the artifacts that were created during the deployment, view the job, and on the right side, select Download artifacts.
Get Started with Pages form is not available
Get Started with Pages form is not available if you:
- Deployed a GitLab Pages site before.
.gitlab-ci.ymlthrough the forms at least one time.
To fix this issue:
- If the message Waiting for the Pages Pipeline to complete appears, select Start over to start the form again.
- If your project has previously deployed GitLab Pages successfully,
manually update your