GitLab Documentation

GitLab Geo troubleshooting

Note: This list is an attempt to document all the moving parts that can go wrong. We are working into getting all this steps verified automatically in a rake task in the future.

Setting up Geo requires careful attention to details and sometimes it's easy to miss a step. Here is a checklist of questions you should ask to try to detect where you have to fix (all commands and path locations are for Omnibus installs):

Visit the primary node's Admin Area ➔ Geo Nodes (/admin/geo_nodes) in your browser. We perform the following health checks on each secondary node to help identify if something is wrong:

GitLab Geo health check