2017-11-01 15:56:40 +00:00
---
2021-01-11 15:10:32 +00:00
stage: Enablement
group: Distribution
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2017-11-01 15:56:40 +00:00
comments: false
---
2021-02-05 15:09:28 +00:00
# Universal update guide for patch versions of source installations
2014-04-24 22:48:22 +00:00
2016-12-02 11:36:05 +00:00
## Select Version to Install
2019-09-18 14:02:45 +00:00
Make sure you view [this update guide ](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/patch_versions.md ) from the tag (version) of GitLab you would like to install.
2020-06-12 03:08:22 +00:00
In most cases this should be the highest numbered production tag (without `rc` in it).
2016-12-02 11:36:05 +00:00
You can select the tag in the version dropdown in the top left corner of GitLab (below the menu bar).
2013-10-28 11:23:09 +00:00
### 0. Backup
2020-04-21 15:21:10 +00:00
It's useful to make a backup just in case things go south. Depending on the installation method, backup commands vary. See the [backing up and restoring GitLab ](../raketasks/backup_restore.md ) documentation.
2013-10-28 11:23:09 +00:00
### 1. Stop server
2020-01-30 15:09:15 +00:00
```shell
2015-12-02 13:54:44 +00:00
sudo service gitlab stop
```
2013-10-28 11:23:09 +00:00
2013-12-06 10:21:33 +00:00
### 2. Get latest code for the stable branch
2013-10-28 11:23:09 +00:00
2015-12-02 13:54:44 +00:00
In the commands below, replace `LATEST_TAG` with the latest GitLab tag you want
to update to, for example `v8.0.3` . Use `git tag -l 'v*.[0-9]' --sort='v:refname'`
to see a list of all tags. Make sure to update patch versions only (check your
current version with `cat VERSION` ).
2020-01-30 15:09:15 +00:00
```shell
2013-10-28 11:23:09 +00:00
cd /home/git/gitlab
2016-12-23 08:53:08 +00:00
2014-02-24 12:04:05 +00:00
sudo -u git -H git fetch --all
2020-03-22 15:09:49 +00:00
sudo -u git -H git checkout -- Gemfile.lock db/structure.sql locale
2015-10-05 13:27:01 +00:00
sudo -u git -H git checkout LATEST_TAG -b LATEST_TAG
2013-10-28 11:23:09 +00:00
```
2020-06-12 03:08:22 +00:00
### 3. Install libraries, migrations, etc
2013-10-28 11:23:09 +00:00
2020-01-30 15:09:15 +00:00
```shell
2013-10-28 11:23:09 +00:00
cd /home/git/gitlab
2016-05-13 16:39:32 +00:00
sudo -u git -H bundle install --without development test mysql --deployment
2013-10-28 11:23:09 +00:00
2016-03-07 14:39:12 +00:00
# Optional: clean up old gems
2016-02-14 09:31:28 +00:00
sudo -u git -H bundle clean
2016-03-07 14:39:12 +00:00
# Run database migrations
2013-10-28 11:23:09 +00:00
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
2016-03-07 14:39:12 +00:00
2017-08-11 12:53:28 +00:00
# Compile GetText PO files
2020-06-10 15:08:07 +00:00
# Internationalization was added in `v9.2.0` so this command is only
2017-08-11 12:53:28 +00:00
# required for versions equal or major to it.
2020-06-10 15:08:07 +00:00
sudo -u git -H bundle exec rake gettext:compile RAILS_ENV=production
2017-08-08 18:08:10 +00:00
2016-03-07 14:39:12 +00:00
# Clean up assets and cache
2019-05-15 16:30:30 +00:00
sudo -u git -H bundle exec rake yarn:install gitlab:assets:clean gitlab:assets:compile cache:clear RAILS_ENV=production NODE_ENV=production NODE_OPTIONS="--max_old_space_size=4096"
2013-10-28 11:23:09 +00:00
```
2019-08-29 08:50:59 +00:00
### 4. Update GitLab Workhorse to the corresponding version
2016-12-23 08:53:08 +00:00
2020-01-30 15:09:15 +00:00
```shell
2016-12-23 08:53:08 +00:00
cd /home/git/gitlab
sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production
```
2019-10-02 12:06:04 +00:00
### 5. Update Gitaly to the corresponding version
2017-09-11 13:27:51 +00:00
2020-01-30 15:09:15 +00:00
```shell
2017-09-11 13:27:51 +00:00
cd /home/git/gitlab
2018-10-17 20:45:20 +00:00
sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production
2017-09-11 13:27:51 +00:00
```
2019-08-29 08:50:59 +00:00
### 6. Update GitLab Shell to the corresponding version
2016-12-23 08:53:08 +00:00
2020-01-30 15:09:15 +00:00
```shell
2016-12-23 08:53:08 +00:00
cd /home/git/gitlab-shell
sudo -u git -H git fetch --all --tags
2018-08-01 16:57:57 +00:00
sudo -u git -H git checkout v$(< /home/git/gitlab/GITLAB_SHELL_VERSION) -b v$(< /home/git/gitlab/GITLAB_SHELL_VERSION)
2019-10-04 12:06:14 +00:00
sudo -u git -H make build
2016-12-23 08:53:08 +00:00
```
2019-08-29 08:50:59 +00:00
### 7. Update GitLab Pages to the corresponding version (skip if not using pages)
2018-08-01 16:57:57 +00:00
2020-01-30 15:09:15 +00:00
```shell
2018-08-01 16:57:57 +00:00
cd /home/git/gitlab-pages
sudo -u git -H git fetch --all --tags
sudo -u git -H git checkout v$(< /home/git/gitlab/GITLAB_PAGES_VERSION)
sudo -u git -H make
```
2021-01-29 12:09:29 +00:00
### 8. Install/Update `gitlab-elasticsearch-indexer` **(PREMIUM SELF)**
2019-05-05 12:17:20 +00:00
2020-02-26 03:09:07 +00:00
Please follow the [install instruction ](../integration/elasticsearch.md#installing-elasticsearch ).
2019-05-05 12:17:20 +00:00
### 9. Start application
2013-10-28 11:23:09 +00:00
2020-01-30 15:09:15 +00:00
```shell
2015-12-02 13:54:44 +00:00
sudo service gitlab start
sudo service nginx restart
```
2013-10-28 11:23:09 +00:00
2019-05-05 12:17:20 +00:00
### 10. Check application status
2013-10-28 11:23:09 +00:00
Check if GitLab and its environment are configured correctly:
2020-01-30 15:09:15 +00:00
```shell
2016-12-23 08:53:08 +00:00
cd /home/git/gitlab
2015-12-02 13:54:44 +00:00
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
```
2013-10-28 11:23:09 +00:00
To make sure you didn't miss anything run a more thorough check with:
2020-01-30 15:09:15 +00:00
```shell
2015-12-02 13:54:44 +00:00
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
```
2013-10-28 11:23:09 +00:00
If all items are green, then congratulations upgrade complete!