Gitlab update to version from 10.*

Hello all,

I wanted to update the gitlab to 12.* from 10.* on debian. Can i upgrade directly to 12.0 ? or should i first upgrade to 11.0 and then 12.* ? Please suggest.

I wrote myself a documentation when I had to update our instance. Hopefully this helps you out (you’ll have to change the version numbers to what is appropriate for your situation - this is just so you have an idea of the steps you need to do to get to where you want).

Version Naming Convention

(Major).(Minor).(Patch) - ex.: 10.7.3 where 10 is the major version, 7 is the minor version and 3 is the patch version numbers.

Official Documentation

As mentioned in the official GitLab Maintenance Policy, generally you should be able to easily and safely upgrade between patch versions and minor versions within the same major version. HOWEVER, upgrading from a major version to the next major version requires more attention.

The general practice should be to upgrade to the latest available version within your major version. Then proceed to upgrading to the next major version.

For example, when trying to upgrade from 10.7.3 to 11.5.0 - you first need to upgrade to the latest version of 10 which is 10.8.5 and then proceed to upgrading to 11.5.0.

Package Download Locations

All GitLab versions can be located in this package list.

When at 10.7.3


sudo apt install gitlab-ce=10.8.5-ce.0


sudo yum install gitlab-ce-10.8.5-ce.0.el7.x86_64

After the upgrade you might have to run (if GitLab is behaving in a weird way)

sudo gitlab-ctl restart

When at 10.8.5


sudo apt-install gitlab-ce=11.5.0-ce.0


sudo yum install gitlab-ce-11.5.0-ce.0.el7.x86_64

Be a little careful though as people have been reporting issues upgrading to 12.x: GitLab omnibus upgrade from 11.11.2-ce.0 to 12.0.0-ce.0 failed

Hi @saga440

You can find the official GitLab [Upgrade recommendations documented here].

If you’re on 10.x, you should follow this upgrade path:
10.8.7 -> 11.3.4 -> 11.11.3 -> 12.0.x

I’ll also create an issue and MR to include the upgrade path for GitLab 12.x in the documentation.

Thanks for the reply.

thanks i guess 11.3.4 is not the major version.

Seems 12.0.* is released just few days back. Hence is it safe to upgrade to the latest veriosn of 12.*. * ?

Hi @saga440,

Upgrading to 12.0 is absolutely safe. We run extensive tests internally before releases are made available. 12.0 should bring some improvements and additional features/functionality.

For the smoothest possible experience, I would suggest following this sequential upgrade path: 10.8.7 -> 11.3.4 -> 11.11.4 -> 12.0.2

You can check that the upgrade was successful between versions with:

sudo gitlab-rake gitlab:check

If you have any problems, reply to this with any error messages and relevant info.


So how come a couple people are reporting issues? I’ve been holding off on upgrading to 12.x because of that thread.