diff --git a/docs/dev/structure.md b/docs/dev/structure.md
index 2fa5ac55..70ae6a0f 100644
--- a/docs/dev/structure.md
+++ b/docs/dev/structure.md
@@ -94,6 +94,8 @@ The aim of the scripts in here is to ensure that applications get upgraded acros
 
 Before any of the upgrade scripts are ran, the `box update` procedure is done.
 
+When `box upgrade --all` is ran, all packages that have install locks will be upgraded **except** a hard-coded list of torrent clients, panel, and nginx.
+
 ### Update
 `scripts/update/`
 
diff --git a/docs/getting-started/box-basics.md b/docs/getting-started/box-basics.md
index 8471f571..9a836d39 100644
--- a/docs/getting-started/box-basics.md
+++ b/docs/getting-started/box-basics.md
@@ -74,6 +74,12 @@ Syntax:
 box upgrade nginx
 ```
 
+Want to just do it for all packages possible? This command will do the trick. _Note:_ this will **not** upgrade torrent clients or nginx, please upgrade those manually.
+
+```bash
+box upgrade --all
+```
+
 ## adduser
 The function used to add a secondary user to your server. Please note, only the master user has access to a significant portion of the included applications