Centos Upgrade OS

Hi guys, currently running self-managed Gitlab CE 17.0.2 on Centos 7.7. Would need to upgrade to new OS due to Centos EOL.

May I know what would be the best approach to upgrading the OS? In-place upgrade of the current server or creating a new server and backup/restore to new server?

Any guidance would be greatly appreciated. Thanks in advance.

Since CentOS 7.x doesn’t have an upgrade process you would be best making a backup. Then install a new server with the same version of Gitlab that you currently have, so 17.0.2 and then restore the backup.

The relevant sections in the Gitlab docs explain the backup/restore process: Back up and restore overview | GitLab

1 Like

Hi Ian, thanks for your prompt reply. I suppose the section I should be referring to would be the Migrate to a new server section.

Just a silly question though: does this restore everything including the LDAP settings and user accounts, meaning restoring everything as is? Thanks.

Everything that is in the database/files are restored, so yes any users in Gitlab will be restored. However, you also need the /etc/gitlab/gitlab.rb and /etc/gitlab/gitlab-secrets.json files since without this you will not have the configuration you were using on your previous server. And these files will be needed to ensure all users/tokens/2fa/ssh keys work.

1 Like