From 71afe35a494d124c12ca4903cec6d5466a5fc9d1 Mon Sep 17 00:00:00 2001
From: maziggy <mz@v8w.de>
Date: Sun, 19 Apr 2026 09:08:30 +0200
Subject: [PATCH] Added new update.sh and update docs

---
 UPDATING.md       | 99 +++++++++++++++++++++++++++++++++++++++++++++++
 install/update.sh | 26 ++++++++++++-
 2 files changed, 124 insertions(+), 1 deletion(-)
 create mode 100644 UPDATING.md

diff --git a/UPDATING.md b/UPDATING.md
new file mode 100644
index 000000000..3f34ef66a
--- /dev/null
+++ b/UPDATING.md
@@ -0,0 +1,99 @@
+# Updating Bambuddy
+
+> **0.2.3 note:** the in-app **Update** button is unreliable when upgrading from
+> older releases. Use the commands below instead — they cover every supported
+> install path and are safe to run repeatedly.
+
+Pick the section that matches how Bambuddy was installed.
+
+---
+
+## Docker
+
+```bash
+# 1. Make sure your compose file isn't pinned to an old version.
+#    The image line should read one of:
+#      image: ghcr.io/maziggy/bambuddy:latest
+#      image: ghcr.io/maziggy/bambuddy:0.2.3
+#    If it pins an older tag (e.g. :0.2.2.2), edit it first.
+
+# 2. Pull and restart
+docker compose pull
+docker compose up -d
+```
+
+**If your `docker-compose.yml` is older than 0.2.3,** also refresh it from the
+repo — recent releases added `cap_add: NET_BIND_SERVICE`, extra virtual-printer
+ports for bridge mode, and an optional Postgres block:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/maziggy/bambuddy/main/docker-compose.yml \
+  -o docker-compose.yml.new
+# Diff against yours, merge by hand, then:
+docker compose up -d
+```
+
+---
+
+## Native install (`install.sh` or manual `git clone`)
+
+Both paths produce a git working tree at the install directory, so the update
+is the same. Preferred:
+
+```bash
+sudo /opt/bambuddy/install/update.sh
+```
+
+`update.sh` stops the service, snapshots the database via the built-in backup
+API, fast-forwards to `origin/main`, installs Python deps, rebuilds the
+frontend, and restarts the service. It rolls back automatically if any step
+fails.
+
+### Manual equivalent
+
+If you'd rather run the steps yourself:
+
+```bash
+cd /opt/bambuddy
+sudo systemctl stop bambuddy
+sudo -u bambuddy git fetch origin
+sudo -u bambuddy git reset --hard origin/main
+sudo -u bambuddy venv/bin/pip install -r requirements.txt
+sudo systemctl start bambuddy
+```
+
+Replace `/opt/bambuddy` with your install path if different. Database schema
+migrations run automatically on startup — no Alembic step is required.
+
+---
+
+## Installed from a GitHub ZIP or tarball download
+
+These installs have no `.git` directory, so neither `update.sh` nor a plain
+`git pull` will work. Reinstall cleanly:
+
+```bash
+# 1. Back up your stateful data
+sudo systemctl stop bambuddy
+sudo tar czf ~/bambuddy-backup.tgz -C /opt/bambuddy \
+  data bambuddy.db bambuddy.db-shm bambuddy.db-wal \
+  virtual_printer archive projects icons .env 2>/dev/null || true
+
+# 2. Remove the old install and reinstall via install.sh
+sudo rm -rf /opt/bambuddy
+curl -fsSL https://raw.githubusercontent.com/maziggy/bambuddy/main/install/install.sh \
+  -o /tmp/install.sh && sudo bash /tmp/install.sh --path /opt/bambuddy
+
+# 3. Restore your data
+sudo systemctl stop bambuddy
+sudo tar xzf ~/bambuddy-backup.tgz -C /opt/bambuddy
+sudo systemctl start bambuddy
+```
+
+---
+
+## Before you upgrade
+
+Take a backup. Settings → Backup → **Create Backup** downloads a ZIP containing
+the database and all stateful directories. Any bare-metal update via
+`update.sh` does this automatically; Docker and manual upgrades do not.
diff --git a/install/update.sh b/install/update.sh
index 6df52955f..942e26333 100755
--- a/install/update.sh
+++ b/install/update.sh
@@ -123,7 +123,31 @@ require_cmd curl
 
 [ -d "$INSTALL_DIR" ] || die "Install directory not found: $INSTALL_DIR"
 cd "$INSTALL_DIR"
-[ -d .git ] || die "No git repository found in: $INSTALL_DIR"
+if [ ! -d .git ]; then
+  cat >&2 <<EOF
+[bambuddy-update] ERROR: No .git directory found in $INSTALL_DIR.
+
+This update script requires a git-based install. If you installed by
+downloading a ZIP or tarball from GitHub, reinstall from scratch:
+
+  1. Back up your data:
+       sudo systemctl stop $SERVICE_NAME
+       sudo tar czf ~/bambuddy-backup.tgz -C $INSTALL_DIR \\
+         data bambuddy.db bambuddy.db-shm bambuddy.db-wal \\
+         virtual_printer archive projects icons .env 2>/dev/null || true
+
+  2. Remove the old install and reinstall via install.sh:
+       sudo rm -rf $INSTALL_DIR
+       curl -fsSL https://raw.githubusercontent.com/maziggy/bambuddy/main/install/install.sh \\
+         -o /tmp/install.sh && sudo bash /tmp/install.sh --path $INSTALL_DIR
+
+  3. Restore your data:
+       sudo systemctl stop $SERVICE_NAME
+       sudo tar xzf ~/bambuddy-backup.tgz -C $INSTALL_DIR
+       sudo systemctl start $SERVICE_NAME
+EOF
+  exit 1
+fi
 
 if [ -z "$BRANCH" ]; then
   BRANCH="$(git rev-parse --abbrev-ref HEAD)"