How to check the version of GitLab?

Question

How to check which version of GitLab is installed on the server?

I am about version specified in GitLab changelog:
https://gitlab.com/gitlab-org/gitlab-foss/blob/master/CHANGELOG.md

For example: "6.5.0", "6.4.3", etc.

Сan this be done only through the terminal?
Is there a way to do that remotely (with browser instead of terminal)?

I’m voting to close this question because this is a question about a product/web app that has nothing to do with development. I think [webapps.se] is a better place for it. — Evan Carroll, Jul 21 '21 at 18:31
For people who are using official GitLab.com, your version is the latest since GitLab is [updated continuously](https://gitlab.com/gitlab-org/release/tasks/-/issues/?_gl=1%2a1osvw75%2a_ga%2aMTc3MDE5ODg4NS4xNjYzNjQxNjIx%2a_ga_ENFH3X7M5Y%2aMTY2OTM1NzIzNy4yMC4xLjE2NjkzNTkyMjEuMC4wLjA.) — louielyl, Nov 25 '22 at 06:56

score 512 · Accepted Answer · edited Jun 20 '20 at 09:12

512

I have updated my server to GitLab 6.6.4 and finally found the way to get version of GitLab remotely without SSH access to server.

You should be logged in to access the following page: https://your.domain.name/help

It shows something similar to:

GitLab 6.6.4 42e34ae

GitLab is open source software to collaborate on code.
...
etc.

edited Jun 20 '20 at 09:12

Community

1
1

answered Mar 03 '14 at 04:03

Maxim

13,029
6
30
45

23

You have to be signed in though. (I've been scratching my head on this for 10 minutes...) – julien_c Feb 17 '16 at 15:19
2

Do you know a way to do this from a filesystem? I.e., a server that no longer boots. – Christophe De Troyer Sep 01 '16 at 12:52
6

Find filename "version-manifest.txt"... For gitlab omnibus it is stored at "/opt/gitlab/version-manifest.txt" – Maxim Sep 01 '16 at 13:42
1

Note: you can see what this looks like on the hosted gitlab at https://gitlab.com/help (if you are logged into that service). – bryanbraun Apr 27 '17 at 03:02
It's sad not work on "https://gitlab.ow2.org/help", maybe it's too old. – Leo Lee Feb 10 '18 at 03:25
1

Using grep: grep "gitlab-ce" /opt/gitlab/version-manifest.txt for community edtion grep "gitlab-ee" /opt/gitlab/version-manifest.txt for enterprise edtion – Marcelo Machado Mar 02 '18 at 17:51
If logged in, use the Help entry in the question-mark-in-circle dropdown. – Thorbjørn Ravn Andersen Aug 24 '21 at 06:42

score 139 · Answer 2 · edited Jul 12 '21 at 14:14

139

For omnibus versions:

sudo gitlab-rake gitlab:env:info

Example:

System information
System:     Ubuntu 12.04
Current User:   git
Using RVM:  no
Ruby Version:   2.1.7p400
Gem Version:    2.2.5
Bundler Version:1.10.6
Rake Version:   10.4.2
Sidekiq Version:3.3.0

GitLab information
Version:    8.2.2
Revision:   08fae2f
Directory:  /opt/gitlab/embedded/service/gitlab-rails
DB Adapter: postgresql
URL:        https://your.hostname
HTTP Clone URL: https://your.hostname/some-group/some-project.git
SSH Clone URL:  git@your.hostname:some-group/some-project.git
Using LDAP: yes
Using Omniauth: no

GitLab Shell
Version:    2.6.8
Repositories:   /var/opt/gitlab/git-data/repositories
Hooks:      /opt/gitlab/embedded/service/gitlab-shell/hooks/
Git:        /opt/gitlab/embedded/bin/git

edited Jul 12 '21 at 14:14

vvvvv

25,404
19
49
81

answered Dec 16 '15 at 20:12

ntwrkguru

1,644
1
11
14

21

It does, but it's SLOW AS HELL. WebURL/help page is much better solution for such a simple task - checking version. – stamster Oct 18 '16 at 11:02
7

@stamster OP asked "Сan this be done only through the terminal?" – ntwrkguru Apr 12 '18 at 22:06
5

What is this command doing that it takes sooo long to get back version info? – Gregory Arenius Sep 07 '18 at 00:39
1

@stamster yes this is slow, but if your running gitlab over a cluster of servers, and if only one server failed the upgrade - you might want to manually check that server. – Reuben deVries Dec 13 '21 at 22:14

John McGehee · Answer 3 · 2020-02-14T01:07:06.530

You can access the version through a URL, the web GUI, and the ReST API.

Via a URL

An HTML page displaying the version can be displayed in a browser at https://your-gitlab-url/help. The version is displayed only if you are signed in.

Via a menu in the web GUI

If you do not care to type this URL, you can also access the same HTML page from a menu in the GitLab web GUI:

In GitLab 11 and later

Log in to GitLab
Click on the drop down menu in the upper right. Select Help.
The GitLab version appears at the top of the page

In earlier versions, like GitLab 9

Log in to GitLab
Click on the drop down menu in the upper left. Select Help.
And then the version appears at the top of the page

Via the ReST API

Log in as any user, select the user icon in the upper right of the screen. Select Settings > Access Tokens. Create a personal access token and copy it to your clipboard.

In a Linux shell, use curl to access the GitLab version:

curl --header "PRIVATE-TOKEN: personal-access-token" your-gitlab-url/api/v4/version

And then? Can you be more specific. I'm trying to set up python-gitlab as a non-admin but fail to find the API version — blkpingu, Oct 18 '18 at 09:59
Gitlab recommend you use the Metadata API instead of the Version API. It contains additional information and is aligned with the GraphQL metadata endpoint. As of GitLab 15.5, the Version API is a mirror of the Metadata API. — Philippe GRANET, Jan 05 '23 at 19:57

score 44 · Answer 4 · answered Mar 29 '18 at 11:53

44

If you are using a self-hosted version of GitLab then you may consider running this command.

grep gitlab /opt/gitlab/version-manifest.txt

answered Mar 29 '18 at 11:53

Arihant Godha

2,339
2
26
50

Easiest solution I've seen so far with GitLab self-hosted 12.10.x, thanks much. – Johnny Utahh May 03 '20 at 21:28
It is better than GitLab recommended answer because does not need to be logged or use URL. – Andry Sep 29 '22 at 15:31

score 27 · Answer 5 · answered Nov 26 '17 at 23:48

You have two choices (after logged in).

Use API url https://gitlab.example.com/api/v4/version (you can use it from command line with private token), it returns {"version":"10.1.0","revision":"5a695c4"}
Use HELP url in browser https://gitlab.example.com/help and you will see version of GitLab, ie GitLab Community Edition 10.1.0 5a695c4

score 23 · Answer 6 · edited Jul 13 '20 at 08:11

23

You can view GitLab's version at: https://your.domain.name/help

Or via terminal: gitlab-rake gitlab:env:info

edited Jul 13 '20 at 08:11

Lewis

4,285
1
23
36

answered Jul 13 '20 at 07:31

Sanyam Jain

331
2
3

score 19 · Answer 7 · edited Oct 28 '17 at 17:30

19

cd /opt/gitlab

cat version-manifest.txt

Example:

gitlab-ctl 6.8.2-omnibus
gitlab-rails v6.8.2

Current gitlab version is 6.8.2

edited Oct 28 '17 at 17:30

Andrei Krasutski

4,913
1
29
35

answered Apr 24 '17 at 07:27

Han Yahui

191
1
4

DLight · Answer 8 · 2023-06-14T17:09:41.610

9

If using the Gitlab Docker image:

# from the host, not inside container
sudo cat /srv/gitlab/data/gitlab-rails/VERSION

Example output:

12.1.3

The same file could be found inside the running container under /var/opt/gitlab/gitlab-rails/VERSION

edited Jun 14 '23 at 17:09

answered Aug 04 '19 at 18:29

DLight

1,535
16
20

I think you mean the mapped path, the file is under a running container under /var/opt/gitlab/gitlab-rails/VERSION But yes, it works. – sneaky Jun 13 '23 at 14:14
@sneaky thanks, I clarified my answer – DLight Jun 14 '23 at 16:50

score 8 · Answer 9 · answered Jan 11 '14 at 23:03

Get information about GitLab and the system it runs on :

bundle exec rake gitlab:env:info RAILS_ENV=production

Example output of gitlab:env:info

System information
System:     Arch Linux
Current User:   git
Using RVM:  yes
RVM Version:    1.20.3
Ruby Version:   2.0.0p0
Gem Version:    2.0.0
Bundler Version:1.3.5
Rake Version:   10.0.4

GitLab information
Version:    5.2.0.pre
Revision:   4353bab
Directory:  /home/git/gitlab
DB Adapter: mysql2
URL:        http://gitlab.arch
HTTP Clone URL: http://gitlab.arch/some-project.git
SSH Clone URL:  git@gitlab.arch:some-project.git
Using LDAP: no
Using Omniauth: no

GitLab Shell
Version:    1.4.0
Repositories:   /home/git/repositories/
Hooks:      /home/git/gitlab-shell/hooks/
Git:        /usr/bin/git

Read this article, it will help you.

It works, but current directory should be changed before to directory where gitlab is installed: cd /home/git/gitlab (otherwise it will report: Could not locale Gemfile). — Maxim, Jan 11 '14 at 23:27
Running Ubuntu 14.04 LTS (trusty) I can use this command to achieve the same: `gitlab-rake gitlab:env:info RAILS_ENV=production` — Thomas Urban, Jun 13 '17 at 13:57

Rajana Deepak · Answer 10 · 2018-05-30T11:33:30.003

Instead of http://domain-name/help you can also check your Gitlab version name in browser by logging as Admin

Go to http://domain-name
Log in to Gitlab as Admin (Root)
Go to Admin Area
On the right corner, below Groups tab, you can find Components tab

There you can find not only Gitlab version but also different components like Gitlab Shell, Gitlab workhorse, Gitlab API etc, version numbers You will also find the suggestions to update the versions there

score 6 · Answer 11 · edited Aug 06 '20 at 16:21

6

cat /opt/gitlab/version-manifest.txt |grep gitlab-ce|awk '{print $2}'

edited Aug 06 '20 at 16:21

Vadim Kotov

8,084
8
48
62

answered May 27 '17 at 08:48

Aborn Jiang

981
10
9

1

Great option to get the version automatically, though using too much code ;) ... try `awk '$1=="gitlab-ce"{print $2}' /opt/gitlab/version-manifest.txt` instead. – Thomas Urban Jun 13 '17 at 14:00
that is fantastic!! – Micromegas Feb 12 '20 at 08:12

score 4 · Answer 12 · answered Nov 25 '17 at 21:14

4

It can be retrieved using REST, see Version API :

curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/version

For authentication see Personal access tokens documentation.

answered Nov 25 '17 at 21:14

Jaroslav Kravec

41
1

score 4 · Answer 13 · answered Dec 12 '19 at 11:07

4

I have Version: 12.2.0-ee and I tried the URL via (https://yourgitlab/help ) but I have not got this information. In the other hand I got this with gitlab-rake with success into the command line:

sudo gitlab-rake gitlab:env:info

... GitLab information Version: 12.2.0-ee ...

answered Dec 12 '19 at 11:07

cesarband

49
1

gitlab.com is also EE and you can easy access https://gitlab.com/help if you are logged in. So you have made something wrong. – Maxim Mar 09 '20 at 02:11

score 4 · Answer 14 · answered May 22 '20 at 05:59

4

The easiest way is to paste the following command:

cat /opt/gitlab/version-manifest.txt | head -n 1

and there you get the version installed. :)

answered May 22 '20 at 05:59

Sebastian

41
3

Neal · Answer 15 · 2021-01-20T22:23:53.870

4

you can use the package manager to query installed version of gitlab-ce. if it happens to be debian or ubuntu, like this:

dpkg -l | grep gitlab-ce | tr -s [:space:] | cut -d" " -f3

should work similarly with other distributions, assuming you used package manager to install.

edited Jan 20 '21 at 22:23

answered Jan 20 '21 at 22:16

Neal

41
2

score 3 · Answer 16 · answered Oct 21 '22 at 15:07

this command line to know all the data of your gitlab install

gitlab-rake gitlab:env:info

and this command line to know are there new Gitlab versions, for you can update gitlab

yum --showduplicates list gitlab-ce

And once you know your current version and the latest gitlab update, you can update it with the following line command

yum install gitlab-ce-15.2.2-ce.0.el7

score 0 · Answer 17 · answered Mar 10 '17 at 10:49

0

If you are an admin and if you want to see the Gitlab version (and more you didn't know about) click on the wrench/admin menu icon and under Components you can see a lot , especially if you are using Omnibus.

answered Mar 10 '17 at 10:49

pjammer

9,489
5
46
56

score 0 · Answer 18 · answered Sep 16 '21 at 11:05

0

To check the version of gitlab on centos

rpm -qa | grep gitlab-ce

answered Sep 16 '21 at 11:05

Dr. Mian

3,334
10
45
69

score 0 · Answer 19 · answered Dec 07 '22 at 07:53

The following information is available from within the CI pipeline (GitLab >= 11.4):

Variable	Value
CI_SERVER_VERSION_MAJOR	The major version of the GitLab instance.
CI_SERVER_VERSION_MINOR	The minor version of the GitLab instance.
CI_SERVER_VERSION_PATCH	The patch version of the GitLab instance.
CI_SERVER_VERSION	The full version of the GitLab instance.