diff --git a/doc/settings/database.md b/doc/settings/database.md
index 878a65757cb53576031355ac85fa2c589b36f1bc_ZG9jL3NldHRpbmdzL2RhdGFiYXNlLm1k..ba049350d8a3cdf4d25209932efabf19d2efc021_ZG9jL3NldHRpbmdzL2RhdGFiYXNlLm1k 100644
--- a/doc/settings/database.md
+++ b/doc/settings/database.md
@@ -772,6 +772,13 @@
 
 ### Upgrade a non-packaged PostgreSQL database
 
+You can upgrade the external database as suggested by the provider after stopping all the processes that are connected to the database (Puma, Sidekiq):
+
+```shell
+sudo gitlab-ctl stop puma
+sudo gitlab-ctl stop sidekiq
+```
+
 Before proceeding with the upgrade, note the following:
 
 - Before upgrading, review the [GitLab and PostgreSQL version compatibility table](../package-information/postgresql_versions.md)
@@ -823,7 +830,7 @@
 1. Shutdown the PostgreSQL 11 database host.
 
 1. Edit `/etc/gitlab/gitlab.rb` and update the `gitlab_rails['db_host']` setting
-   to point to the PostgreSQL database 11 host.
+   to point to the PostgreSQL database 12 host.
 
 1. Reconfigure GitLab: