Quick summary
Upgrading GitLab requires following a sequential upgrade path — you cannot skip versions. This guide walks you through identifying your target version, checking requirements, and running the upgrade command from your terminal.
Steps
- Open GitLab on your computer to begin the upgrade process.
- Identify the version you wish to upgrade to.
- Use the upgrade path tool at gitlab-com.gitlab.io to determine your upgrade path.
- Review the upgrade path and note that versions must be upgraded sequentially without skipping.
- Review the changes and requirements on the GitLab site for your desired target version.
- Ensure there are no active runners or jobs running before proceeding.
- Check for application updates in your terminal.
- Update the package list from the repository to view available GitLab versions.
- Run the command to start the upgrade to your chosen version.
- Confirm the installation is complete — you have successfully upgraded to the new version of GitLab.
