You have to activate the pages feature. In your gitlab.rb:

pages_external_url "IP_OF_YOUR_GITLAB"
gitlab_pages['enable'] = true

There is a tutorial: https://www.youtube.com/watch?v=dD8c7WNcc6s&feature=youtu.be And the complete documentation: https://docs.gitlab.com/ce/administration/pages/index.html

Answer from Jeremad on Stack Overflow
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › update your settings › gitlab pages › gitlab pages for source installations
GitLab Pages administration for self-compiled installations | GitLab Docs
GitLab Pages must run on its own virtual host. In your DNS server or provider, add a wildcard DNS A record pointing to the host that GitLab runs on.
🌐
GitLab
forum.gitlab.com › how to use gitlab › self-managed
Self-hosted gitlab Pages access - Self-managed - GitLab Forum
December 22, 2022 - Hi, I’m currently attempting to host a gitlab pages site on a self-hosted gitlab server. I keep running in circles and believe there could be something I’m simply not understanding. It’s a project based page (jekyll/just-the-docs) to be exact and when permissions are set to visibility “Everyone” the site is available at groupname.mydomain.pl/projectname.
Discussions

Self hosted Gitlab CE how to get Pages?
I did it in my org, we deploy in kunernetes, what you need is a domain to point to your gitlab container. Gitlab will resolve anything like *.mypages.com More on reddit.com
🌐 r/gitlab
2
3
January 8, 2026
[Gitlab]Where can I find Gitlab Pages hosted on my private Gitlab instance? - Stack Overflow
I tried to set up Gitlab Pages, until now I finished uploading my static website files👇 Uploading artifacts... coverage/lcov-report: found 77 matching files Uploading artifacts to coordinat... More on stackoverflow.com
🌐 stackoverflow.com
Gitlab CE self host - Pages query
Short answer is yes. https://docs.gitlab.com/ee/administration/pages/ https://docs.gitlab.com/ee/user/project/pages/ We have https://gitlab.company.com and have two CNAMES that resolve on-network to http://pages.gitlabpages.company.com/our-repo and https://our-repo.company.com as well. More on reddit.com
🌐 r/gitlab
2
3
May 24, 2019
Gitlab pages self hosted with access control enabled, behind docker-compose and traefik2
Hi ! I have a docker instance of self-hosted Gitlab and I wanted to add gitlab pages to it… All of this runs behind traefik2 (a reverse proxy). I was able to make gitlab pages work normally, but when I enabled access_control, it didn’t work anymore… If the repository is public, the pages ... More on forum.gitlab.com
🌐 forum.gitlab.com
1
0
April 13, 2022
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › update your settings › gitlab pages
GitLab Pages administration | GitLab Docs
The GitLab Pages daemon runs as a separate process and can be configured either on the same server as GitLab or on its own dedicated infrastructure. For user documentation, see GitLab Pages. This guide is for Linux package installations. For self-compiled installations, see GitLab Pages administration for self-compiled installations.
🌐
Reddit
reddit.com › r/gitlab › self hosted gitlab ce how to get pages?
r/gitlab on Reddit: Self hosted Gitlab CE how to get Pages?
January 8, 2026 -

Does anyone have advice on how to configure pages/gitlab.

I have a home lab with Nginx proxy Manager being used to redirect to various Docker containers hosted on it, using ports.

I have been working on a docker-compose file for Gitlab which can be found here this deploys a Gitlab CE, Redis & Postgres and configure them to integrate.

I have also developed a pipeline which generate documentation sites and the pages job and Gitlab seems to detect the generated website and store them against the pages URL.

Reading the documentation, I can't quite understand how I need to configure compose/gitlab so I can use a nginx redirect. I have tried googling and assume I am missing something obvious.

Any ideas from the community would be really appreciated.

🌐
Shafik Walakaka
blog.shafikwalakaka.com › tech-adventures › security-cookies-and-more › gitlab-pages-self-hosted-vs-cloud
GitLab Pages – Self Hosted v Cloud | Shafik Walakaka
Knowing the differences is key – because for GitLab pages to be active, there are some additional administrative setup that is required to support this feature. In Cloud GitLab, this has already been setup, and we can already use it as you can see in our GitLab Pages Intro. But in self-hosted GitLab, this was different!
🌐
GitLab
docs.gitlab.com › gitlab docs › use gitlab › deploy and release your application › gitlab pages
GitLab Pages | GitLab Docs
To restrict access to your website, enable GitLab Pages Access Control. If you’re using a GitLab Self-Managed instance, your websites are published on your own server, according to the Pages settings chosen by your sysadmin, who can make them public or internal.
Find elsewhere
🌐
DZone
dzone.com › data engineering › ai/ml › running self-hosted gitlab pages behind reverse proxy and in a separate server
Running Self-Hosted GitLab Pages Behind Reverse Proxy and In a Separate Server
September 17, 2019 - In this scenario, one of GitLabs generates and manages the Pages and the other (gitlab-pages) hosts and publishes them, so we need to share a directory on gitlab-pages and make it accessible by the main GitLab instance (installed on gitlab-master).
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › configure gitlab › host the product documentation
Host the GitLab product documentation | GitLab Docs
Offering: GitLab Self-Managed · If you are not able to access the GitLab product documentation at docs.gitlab.com, you can host the documentation yourself instead. The local help of your instance does not include all the docs (for example, it doesn’t include docs for GitLab Runner or GitLab ...
🌐
Evidence
docs.evidence.dev › deployment › self-host › gitlab-pages
GitLab Pages
GitLab Pages is a service that allows you to host static websites and single-page apps.
🌐
Reddit
reddit.com › r/gitlab › gitlab ce self host - pages query
r/gitlab on Reddit: Gitlab CE self host - Pages query
May 24, 2019 -

All,

I have a self-hosted instance of Gitlab CE and would like to use Gitlab Pages and CI to publish documentation.I have my own domain which is world accessible - i.e. mydomain.co.uk. Is it possible to publish my live documentation to docs.mydomain.co.uk ?

Or do I need a completely different domain to publish to? I have DNS control of my domain so can amend as necessary.

🌐
GitLab
forum.gitlab.com › general
Gitlab pages self hosted with access control enabled, behind docker-compose and traefik2 - General - GitLab Forum
April 13, 2022 - Hi ! I have a docker instance of self-hosted Gitlab and I wanted to add gitlab pages to it… All of this runs behind traefik2 (a reverse proxy). I was able to make gitlab pages work normally, but when I enabled access_con…
🌐
GitLab
forum.gitlab.com › how to use gitlab › self-managed
Gitlab pages settings - Self-managed - GitLab Forum
August 20, 2021 - Hi all. We have Gitlab 13.4.2 self hosted and I’d like to enables pages on the same server, same IP but different port. What do I need to change within gitlab.rd to do so? I couldn’t find a proper docs as most of them …
🌐
DEV Community
dev.to › nuculabs_dev › self-hosting-gitlab-44hp
Self Hosting Gitlab - DEV Community
January 4, 2026 - After that's done all you need is to create a route and Cloudflare will update the DNS entries automatically and you can access your Gitlab instance via HTTPS. ... Why self-hosting is cheaper than cloud.
🌐
Reddit
reddit.com › r/gitlab › please help with the setup of pages and registry for a selfhosted gitlab instance
r/gitlab on Reddit: please help with the setup of pages and registry for a selfhosted Gitlab instance
January 10, 2024 -

As the title states this question is about adding a pages and container registry host to a self-hosted Gitlab instance.

Pages: I'm looking for a description on how to set up an external pages host and have my the Gitlab CI/CD push sites to this host. I tried to look for this but I only ever find descriptions of how to use an already existing in gitlab-ci.yml. Feels like I may be missing something fundamental here.

Container registry: I'd like to publish images from the CI/CD to this registry. Admittedly I've not looked into this to the same extend as pages, but the docs I found are very vague.

Much appreciated!

🌐
Tombroughton
tombroughton.me › series › self-hosted-gitlab-in-docker
Self-Hosted Docker Gitlab, CI and Pages
December 4, 2020 - Gitlab will need 2 host domains, one to route to the main Gitlab UI and the second to route to the published Gitlab pages.
🌐
Gitlab
how-to-stuff.gitlab.io › gitlab-pages-how-to
How To: GitLab Pages - HTML Hosted Page
To do that, we need to add another few lines to our .yml file, telling the Runner to only perform that job called pages (everything in the public directory) on the master branch only - resulting in this: That's all you need to get started! If you're building a more complex example take a look at this article that lists all of the build variables. These variables have already gone through some changes, so it's good to bookmark. ;) Now that we have everything composed, we're ready to push all of the assets we have to our GitLab project.
🌐
GitLab
forum.gitlab.com › how to use gitlab › self-managed
Gitlab pages not getting enabled - Self-managed - GitLab Forum
June 7, 2023 - Hello I tried to enable gitlab-pages on self-hosted Omnibus GitLab instance by following GitLab Pages administration | GitLab instructions. I started with the minimal set of requirements to enable the gitlab-pages but no. lock. external_url “https://gitlab.example.com” # external_url here is only for reference pages_external_url “https://pages.example.com” # not a subdomain of external_url Even I’m not seeing any error in gitlab logs.
🌐
GitLab
docs.gitlab.com › gitlab docs › use gitlab › deploy and release your application › gitlab pages › default domain names and urls
GitLab Pages default domain names and URLs | GitLab Docs
If you set up a GitLab Pages project on GitLab, it’s automatically accessible under a subdomain of namespace.example.io. The namespace is defined by your username on GitLab.com, or the group name you created this project under. For GitLab Self-Managed, replace example.io with your instance’s Pages domain.
🌐
PRACE
repository.prace-ri.eu › help
Index · Pages · Project · User · Help · GitLab
If you're using a self-managed instance, your websites are published on your own server, according to the Pages settings chosen by your sysadmin, who can make them public or internal.