diff --git a/README.md b/README.md
index 8acea47..8330609 100644
--- a/README.md
+++ b/README.md
@@ -85,6 +85,14 @@ Below is a mapping of container `/config` paths to those relative within a BookS
 - `/config/www/themes/` => `themes/`
 - `/config/www/uploads/` => `public/uploads/`
 
+### Changing APP_URL
+
+If you change the APP_URL after initial install, you should run the following line from your host terminal to update the database URL entries:
+
+```shell
+docker exec -it bookstack php /app/www/artisan bookstack:update-url ${OLD_URL} ${NEW_URL}
+```
+
 ### Advanced Users (full control over the .env file)
 
 If you wish to use the extra functionality of BookStack such as email, Memcache, LDAP and so on you will need to make your own .env file with guidance from the BookStack documentation.
diff --git a/readme-vars.yml b/readme-vars.yml
index d6e2c47..3cc7bce 100644
--- a/readme-vars.yml
+++ b/readme-vars.yml
@@ -66,6 +66,14 @@ app_setup_block: |
   - `/config/www/themes/` => `themes/`
   - `/config/www/uploads/` => `public/uploads/`
 
+  ### Changing APP_URL
+
+  If you change the APP_URL after initial install, you should run the following line from your host terminal to update the database URL entries:
+
+  ```shell
+  docker exec -it bookstack php /app/www/artisan bookstack:update-url ${OLD_URL} ${NEW_URL}
+  ```
+
   ### Advanced Users (full control over the .env file)
 
   If you wish to use the extra functionality of BookStack such as email, Memcache, LDAP and so on you will need to make your own .env file with guidance from the BookStack documentation.