diff --git a/docs/deployment/vps.md b/docs/deployment/vps.md
index 326f39a..31d308e 100644
--- a/docs/deployment/vps.md
+++ b/docs/deployment/vps.md
@@ -72,7 +72,7 @@ while read oldrev newrev refname; do
   rsync -a --delete $DEPLOY/site/dist/ /var/www/bincio/
 
   echo "--- Restarting API ---"
-  systemctl restart bincio
+  systemctl restart bincio || echo "WARNING: bincio service restart failed — check journalctl -u bincio"
 
   echo "--- Done ---"
 done
@@ -169,6 +169,12 @@ uv run bincio init \
 # prompted for password; prints a first invite code
 ```
 
+Enable the edit/upload UI (this env var is read at build time and is gitignored, so it must be set on the server):
+
+```bash
+echo "PUBLIC_EDIT_ENABLED=true" > /opt/bincio/site/.env
+```
+
 Set the user cap:
 
 ```bash