diff --git a/INSTALL/UPGRADE.md b/INSTALL/UPGRADE.md
new file mode 100644
index 0000000..a74e152
--- /dev/null
+++ b/INSTALL/UPGRADE.md
@@ -0,0 +1,18 @@
+# Upgrade Cerebrate
+
+To upgrade a local cerebrate installation, simply pull the new code from the remote `main` branch:
+
+```bash
+sudo -u www-data git -C /var/www/cerebrate/ pull origin main
+```
+
+If you need to use a proxy, you can pass them to the command like this:
+
+```bash
+https_proxy=http://proxy.local:8080 sudo -Eu www-data git -C /var/www/cerebrate/ pull origin main
+```
+
+To upgrade the database, login to the webinterface as administrator and call
+http://cerebrate.local:8000/instance/migrationIndex
+Also available from the menu in the interface as "Database migration".
+Run all available upgrades.
diff --git a/README.md b/README.md
index a00ccc6..c2dfa33 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ Managing public keys and assigning them to users both for communication and vali
 
 The platform is built on CakePHP 4 along with Bootstrap 4 and shares parts of the code-base with [MISP](https://www.github.com/MISP).
 
-The installation is documented at the following location [INSTALL/INSTALL.md](INSTALL/INSTALL.md)
+The installation is documented at the following location [INSTALL/INSTALL.md](INSTALL/INSTALL.md). For upgrades, look at [INSTALL/UPGRADE.md](INSTALL/UPGRADE.md)
 
 Hardware requirements: