I assume you don't want to use GitLab shared runner which costs you and CI minutes limits.

Public folder

Refer to this gitlab-ci.yaml for making HTML content available https://gitlab.com/pages/plain-html/-/blob/master/.gitlab-ci.yml

Running locally without registration

Here is the known limitations: https://docs.gitlab.com/runner/commands/#limitations-of-gitlab-runner-exec

Pages are directly managed by Gitlab so running locally won't affect the page's state.

Use your own runner and register with gitlab (Possible)

Install GitLab runner on your machine and register as a runner, instructions can be found at Settings->CI/CD->Runners->Specific runner Enable it for your project or group.

I use my personal machine gitlab-runner to execute CI jobs that aren't counted towards CI minutes.

Answer from Raghu Vijaykumar on Stack Overflow
🌐
Reddit
reddit.com › r/gitlab › how to publish a plain html web site on gitlab pages without ci's, runner's, etc?
r/gitlab on Reddit: How to publish a plain html web site on GitLab Pages without CI's, runner's, etc?
August 12, 2022 -

GitLab decided to limit access to their CI functionality a year ago, but I cannot find any instructions on how to publish plain html web site on GitLab Pages without CI. If they do not want people to use CI, then should not be there clear instructions on how to do thing that do not need the CI features without it?

Discussions

r markdown - Publish static HTML to GitLab pages (no build, no CI/CD) - Stack Overflow
For your use case, you just need to put your web page files (like index.html) into the public directory and run the CI pipeline once. If your repository is on gitlab.com, one of the public runners can be used with your project without setting up any custom runners. More on stackoverflow.com
🌐 stackoverflow.com
How to publish a plain html web site on GitLab Pages without CI's, runner's, etc? - Stack Overflow
I want to use GitLab Pages service, but I am unable/not willing to provide my card to enable GitLab CI, which is now restricted. How can I publish a plain html website without using any of this More on stackoverflow.com
🌐 stackoverflow.com
Is it necessary to run gitlab-ci and creating .gitlab-ci.yml for gitlab pages
Can’t we put all stuff in just public folder manually. If can’t do then why ? Why gitlab-ci is necessary to deploy gitlab pages site. More on forum.gitlab.com
🌐 forum.gitlab.com
4
0
May 7, 2021
Is it possible to upload pages without the Pages job?
Is it possible to upload the public folder from a job for GitLab pages site without the use of the pages: job? More on forum.gitlab.com
🌐 forum.gitlab.com
2
0
July 22, 2022
🌐
GitLab
forum.gitlab.com › gitlab ci/cd
Deploy GItLab Pages without CI/CD? - GitLab CI/CD - GitLab Forum
August 6, 2022 - I don’t like CI/CD, never a fan of, it is horrible and slow, always takes like 5 minues to deploy simple changes. Is it possible to deploy GitLab Pages without CI/CD, or is it mandatory to have CI/CD and a runner? Other sites Github and Bitbucket does not need to run CI/CD at all just for pages.
🌐
Stack Overflow
stackoverflow.com › questions › 73330317 › how-to-publish-a-plain-html-web-site-on-gitlab-pages-without-cis-runners-etc
How to publish a plain html web site on GitLab Pages without CI's, runner's, etc? - Stack Overflow
The flow is simple and no CB is required (it's a non-profit living from donations): to enable HTML rendering, at the root of your repo, add a file called .gitlab-ci.yml containing the following lines: pages: script: - mkdir .public - cp -r * .public - mv .public public artifacts: paths: - public
🌐
GitLab
forum.gitlab.com › gitlab ci/cd
Is it necessary to run gitlab-ci and creating .gitlab-ci.yml for gitlab pages - GitLab CI/CD - GitLab Forum
May 7, 2021 - Can’t we put all stuff in just public folder manually. If can’t do then why ? Why gitlab-ci is necessary to deploy gitlab pages site.
🌐
GitLab
forum.gitlab.com › gitlab ci/cd
Is it possible to upload pages without the Pages job? - GitLab CI/CD - GitLab Forum
July 22, 2022 - Is it possible to upload the public folder from a job for GitLab pages site without the use of the pages: job?
Find elsewhere
🌐
Gitlab
k33g.gitlab.io › articles › 2020-07-23-GITLAB-PAGES-EN.html
🇬🇧 Every GitLab Page deserves a real CI/CD | K33G's website
So, it means that you can deploy a GitLab Page from a feature branch, without impacting your production page, in a new temporary environment 🤩 · It's not documented on how to use this feature with the GitLab Pages. But the trick is easy. Let's me explain: Change again your .gitlab-ci.yml file ...
🌐
GitLab
gitlab.com › gitlab pages examples › plain-html
GitLab Pages examples / plain-html · GitLab
Example plain HTML site using GitLab Pages: https://pages.gitlab.io/plain-html
🌐
GitHub
github.com › YuMS › gitlab-ce-pages
GitHub - YuMS/gitlab-ce-pages: Unofficial GitLab Pages for GitLab CE · GitHub
Unofficial GitLab Pages for GitLab CE. Contribute to YuMS/gitlab-ce-pages development by creating an account on GitHub.
Author: YuMS
🌐
Medium
medium.com › turpialdev › how-to-host-an-html-page-in-gitlab-pages-47bbfbdeb4d1
How to host an HTML page in GitLab Pages | by Turpial Development | Turpial Dev | Medium
November 27, 2018 - How to host an HTML page in GitLab Pages GitLab is a software for managing version control of git. They have a free and paid community version. You can also use their servers and host your projects …
🌐
GitLab
docs.gitlab.com › gitlab docs › use gitlab › deploy and release your application › gitlab pages
GitLab Pages | GitLab Docs
You can also set a custom folder to be deployed with Pages. When you create a new project in GitLab, a repository becomes available automatically. To deploy your site, GitLab uses its built-in tool called GitLab CI/CD to build your site and publish it to the GitLab Pages server.
🌐
GitLab
docs.gitlab.com › gitlab docs › use gitlab › deploy and release your application › gitlab pages › settings
GitLab Pages settings | GitLab Docs
Domain of the instance: domain name that is used for GitLab Pages (ask your administrator). GitLab CI/CD: a .gitlab-ci.yml file with a specific job named pages in the root directory of your repository.
🌐
Reddit
reddit.com › r/gitlab › configuring gitlab pages help!
r/gitlab on Reddit: Configuring GitLab Pages Help!
January 8, 2025 - I have a pipeline on our documentation that is trying to publish to pages, it gives me a tick but I can't confirm if it has done anything. ... DISCLAIMER: The environment we operated in to get GitLab pages to work may be different than yours in ways I don't know yet so please take this guide with a grain of salt.
🌐
OneUptime
oneuptime.com › home › blog › how to set up pages deployment in gitlab ci
How to Set Up Pages Deployment in GitLab CI
December 21, 2025 - GitLab Pages automatically provisions Let's Encrypt certificates for custom domains. # No special CI configuration needed for HTTPS # Enable in Deploy > Pages > Force HTTPS deploy_pages: stage: deploy script: - mv dist public pages: true artifacts: ...
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › update your settings › gitlab pages
GitLab Pages administration | GitLab Docs
In addition to wildcard domains, you can configure GitLab Pages to work with custom domains, with or without TLS certificates. In either case, you need a secondary IP.
🌐
GitLab
about.gitlab.com › blog › product › build a new website in a few easy steps with gitlab pages
Build a new website in a few easy steps with GitLab Pages
March 3, 2025 - This tutorial shows you how to create and host your personal website using GitLab Pages with a ready-to-use template that you can customize in minutes.
🌐
GitLab
gitlab.com › gitlab.org › gitlab-pages
GitLab.org / gitlab-pages · GitLab
GitLab Pages daemon used to serve static websites for GitLab users
🌐
GitLab
forum.gitlab.com › how to use gitlab
GitLab Pages: serve page without .html extension - How to Use GitLab - GitLab Forum
September 8, 2017 - TL;DR: I need to know how to serve a page in GitLab pages without a .html (or anything else) extension at the end of the URL. Thanks! Hi, I’m trying to renew my HTTPS certificate using Let’s Encrypt. I’m at the step where I have to add a page with some text in it to prove that I own the website, as described in this section of GitLab’s own article describing how to do it.
🌐
GitLab
gitlab.com › gitlab pages examples
GitLab Pages examples · GitLab
Example websites hosted by GitLab Pages. Learn how to contribute a new Pages site.