Using a Geo Site

After you set up the database replication and configure the Geo nodes, use your closest GitLab site as you would do with the primary one.

You can push directly to a secondary site (for both HTTP, SSH including Git LFS), and the request is proxied to the primary site instead.

Example of the output you see when pushing to a secondary site:

$ git push
remote: This request to a Geo secondary node will be forwarded to the
remote: Geo primary node:
remote:   ssh://git@primary.geo/user/repo.git
Everything up-to-date
If you’re using HTTPS instead of SSH to push to the secondary, you can’t store credentials in the URL like user:password@URL. Instead, you can use a .netrc file for Unix-like operating systems or _netrc for Windows. In that case, the credentials are stored as a plain text. If you’re looking for a more secure way to store credentials, you can use Git Credential Storage.

Fetch Go modules from Geo secondary sites

Go modules can be pulled from secondary sites, with a number of limitations:

  • Git configuration (using insteadOf) is needed to fetch data from the Geo secondary site.
  • For private projects, authentication details need to be specified in ~/.netrc.

Read more in the working with projects go get documentation.