Setting up Geo (PREMIUM SELF)

These instructions assume you have a working instance of GitLab. They guide you through:

  1. Making your existing instance the primary site.
  2. Adding secondary site(s).

WARNING: The steps below should be followed in the order they appear. Make sure the GitLab version is the same on all sites.

Using Omnibus GitLab

If you installed GitLab using the Omnibus packages (highly recommended):

  1. Install GitLab Enterprise Edition on the node(s) that will serve as the secondary site. Do not create an account or log in to the new secondary site.
  2. Upload the GitLab License on the primary site to unlock Geo. The license must be for GitLab Premium or higher.
  3. Set up the database replication (primary (read-write) <-> secondary (read-only) topology).
  4. Configure fast lookup of authorized SSH keys in the database. This step is required and needs to be done on both the primary and secondary site(s).
  5. Configure GitLab to set the primary and secondary site(s).
  6. Optional: Configure a secondary LDAP server for the secondary site(s). See notes on LDAP.
  7. Follow the Using a Geo Site guide.
  8. Configure Geo secondary proxying to use a single, unified URL for all Geo sites. This step is recommended to accelerate most read requests while transparently proxying writes to the primary Geo site.

Post-installation documentation

After installing GitLab on the secondary site(s) and performing the initial configuration, see the following documentation for post-installation information.