Knowing which version of GitLab you’re running is essential for maintenance, compatibility, security updates, and troubleshooting. Whether you’re using GitLab self-managed (Community or Enterprise Edition) or interacting with an instance via the web interface, there are several ways to find the current GitLab version.
This guide outlines multiple methods to check your GitLab version accurately.
✅ Method 1: Check GitLab Version from the Web Interface
If you have access to the GitLab UI:
- Log in to your GitLab instance.
- Click on your profile icon (top-right).
- Go to Help or visit directly:
https://your-gitlab-instance/help - The version number will be listed at the top of the page, e.g.:
GitLab Community Edition 15.9.2
✅ Method 2: Check GitLab Version via Command Line (for Self-Hosted)
If you’re running a self-managed GitLab server, SSH into the server and run:
gitlab-rake gitlab:env:info
This will output environment and version information like:
System information
System: Ubuntu 22.04
...
GitLab: 16.3.1 (CE)
Alternatively, you can check via:
cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
📍 Path may vary depending on how GitLab was installed.
✅ Method 3: Check via API
If you prefer programmatic access, use the GitLab REST API:
curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/version
Response:
{
"version": "16.2.0",
"revision": "abc123def456"
}
🧩 Summary
| Method | Command/Path |
|---|---|
| GitLab UI | https://your-gitlab-instance/help |
| Command Line | gitlab-rake gitlab:env:info |
| File Check | cat /opt/gitlab/embedded/.../VERSION |
| GitLab API | GET /api/v4/version |
📌 Final Tips
- Always use the latest supported version to benefit from security updates.
- If you’re managing multiple GitLab instances, automate version checks using the API.
- Enterprise features may vary by version—check GitLab release notes for details.
