This is the documentation for configuring a GitLab Pages when you have installed
This document explains how to configure GitLab Pages when you have installed
GitLab from source and not using the Omnibus packages.
GitLab from source and not the Omnibus packages.
You are encouraged to read the [Omnibus documentation](index.md) as it provides
You are encouraged to read the [Omnibus documentation](index.md) as it provides
invaluable information about the configuration of GitLab Pages.
invaluable information about the configuration of GitLab Pages.
...
@@ -22,10 +22,9 @@ Pages to the latest supported version.
...
@@ -22,10 +22,9 @@ Pages to the latest supported version.
## Overview
## Overview
GitLab Pages makes use of the [GitLab Pages daemon](https://gitlab.com/gitlab-org/gitlab-pages), a simple HTTP server
GitLab Pages makes use of the [GitLab Pages daemon](https://gitlab.com/gitlab-org/gitlab-pages), a lightweight HTTP server that listens on an external IP address and provides support for
written in Go that can listen on an external IP address and provide support for
custom domains and certificates. It supports dynamic certificates through
custom domains and custom certificates. It supports dynamic certificates through
`SNI` and exposes pages using HTTP2 by default.
SNI and exposes pages using HTTP2 by default.
You are encouraged to read its [README](https://gitlab.com/gitlab-org/gitlab-pages/blob/master/README.md)
You are encouraged to read its [README](https://gitlab.com/gitlab-org/gitlab-pages/blob/master/README.md)
to fully understand how it works.
to fully understand how it works.
...
@@ -57,7 +56,7 @@ Before proceeding with the Pages configuration, make sure that:
...
@@ -57,7 +56,7 @@ Before proceeding with the Pages configuration, make sure that:
assume that to be `example.io`.
assume that to be `example.io`.
- You have configured a **wildcard DNS record** for that domain.
- You have configured a **wildcard DNS record** for that domain.
- You have installed the `zip` and `unzip` packages in the same server that
- You have installed the `zip` and `unzip` packages in the same server that
GitLab is installed since they are needed to compress and decompress the
GitLab is installed because they are needed to compress and decompress the
Pages artifacts.
Pages artifacts.
- Optional. You have a **wildcard certificate** for the Pages domain if you
- Optional. You have a **wildcard certificate** for the Pages domain if you
decide to serve Pages (`*.example.io`) under HTTPS.
decide to serve Pages (`*.example.io`) under HTTPS.
...
@@ -86,7 +85,7 @@ see the [security section](#security).
...
@@ -86,7 +85,7 @@ see the [security section](#security).
Depending on your needs, you can set up GitLab Pages in 4 different ways.
Depending on your needs, you can set up GitLab Pages in 4 different ways.
The following options are listed from the easiest setup to the most
The following options are listed from the easiest setup to the most
advanced one. The absolute minimum requirement is to set up the wildcard DNS
advanced one. The absolute minimum requirement is to set up the wildcard DNS
since that is needed in all configurations.
because that is needed in all configurations.
### Wildcard domains
### Wildcard domains
...
@@ -96,7 +95,7 @@ since that is needed in all configurations.
...
@@ -96,7 +95,7 @@ since that is needed in all configurations.