Migrating Repo Storage

Hey Guys

New here, so please excuse the inevitable knowledge gaps. I’ll try to be concise to make up the difference…

We run an on-prem Gitlab EE server, version 12.0.2 on Centos 7. For conciseness;


Currently, our repo storage location is a mount point connected to a NAS, and it contains about 7GB of .git files. For various reasons, including that pointing at a NAS for this fills me some horror, we’d like to move the repo location from this mountpoint/NAS to a local storage location which is part of the server.

I already/mount point allocated and with enough storage space, but before touching anything I wanted to confirm that I am following the right process to safely move the repo.

If my digging around for answers is correct, I am going to follow this process;

  1. Stop the Gitlab services.
  2. Copy the data from /nasmountpoint to /local/data/gitrepo/
  3. Browse to/open /var/opt/gitlab/gitaly/config.toml
  4. Under [[storage]] change path = ‘/gitrepo/repositories’ to the /local/data/gitrepo folder above.
  5. Unmount /nasmountpoint (to be sure it is no longer being used)
  6. Start the Gitlab services

As I said, pretty fresh to Gitlab in general, so please scream at me if the above is incorrect, incomplete or unnecessarily risky.

Much appreciated!



looks good to me with one exception: Reading the Gitaly docs, especially for the storage parts, makes me believe that you need to ensure that both, config.toml and GitLab’s main config file gitlab.rb are in sync with the storage paths - if you run both on the same host.


These names and paths are also defined in the gitlab.yml configuration file of GitLab. When you run Gitaly on the same machine as GitLab, which is the default and recommended configuration, storage paths defined in Gitaly’s config.toml must match those in gitlab.yml .

(not sure why it is called gitlab.yml here, I guess that’s a typo)

After modifying the config files, make sure to reconfigure GitLab before restarting it.

One thing I’d suggest doing before going anywhere else - take a full backup snapshot of that server. So in case there are troubles, you can always restore and rollback.


1 Like

Hi Michael

That’s really great, thank you for taking the time to reply.

I’ll definitely be taking the time to snapshot/backup before making any changes, as this is all live. In terms of that Gitlab.yml file you referenced, do you know off the top of your head what the correct file is if it isn’t gitlab.yml?

Thank you!


/etc/gitlab/gitlab.rb contains the main GitLab configuration, the storage options are mentioned here.


Perfect, thank you. I’ll check both of those config files, put a process together and let you know how I get on. :slight_smile:

Much appreciated Michael.


1 Like