Release v0.1.6 2026-07-12

DEPLOYMENT.md

@@ -4,6 +4,17 @@ This game uses the same proven local-Gitea pattern as `testgame`: clone from the
 Gitea bare repository on the TrueNAS filesystem, mount that working checkout
 into one Node container, and update it with a local Git pull plus app restart.
 
+## What the TrueNAS server does
+
+The `iwanttoheal-mmo` TrueNAS app is the game's live online server. One Node
+process serves the browser bundle and authenticated `/api` routes on port `4173`.
+The reverse proxy exposes both at `https://iwanttoheal.phenomrom.com`.
+
+SQLite persists accounts, sessions, cloud saves, boss-kill rankings, and
+roguelike records under `/app/data/game.db`. The separate data mount survives
+container replacement. TrueNAS Gitea remains the source repository used for
+deployment; it is not the game database.
+
 ## Paths
 
 ```text
@@ -13,6 +24,9 @@ Local Gitea bare repository:
 Runnable working checkout:
 /mnt/usbssds/apps/iwanttoheal-mmo/app
 
+Persistent game data:
+/mnt/usbssds/apps/iwanttoheal-mmo/data
+
 Public URL:
 https://iwanttoheal.phenomrom.com
 
@@ -39,7 +53,7 @@ sudo find /mnt -type d -name "i-want-to-heal-mmo.git" -prune -print 2>/dev/null
 Clone entirely through the local filesystem:
 
 ```sh
-sudo mkdir -p /mnt/usbssds/apps/iwanttoheal-mmo
+sudo mkdir -p /mnt/usbssds/apps/iwanttoheal-mmo/{app,data}
 sudo git config --global --add safe.directory \
   /mnt/.ix-apps/app_mounts/gitea/data/git/repositories/phenom/i-want-to-heal-mmo.git
 sudo git clone \
@@ -72,8 +86,10 @@ services:
   iwanttoheal:
     image: node:24-bookworm-slim
     command: >-
-      sh -lc "corepack pnpm install --frozen-lockfile && corepack pnpm run build && corepack pnpm start"
+      sh -lc "corepack pnpm install --frozen-lockfile && corepack pnpm run db:init && corepack pnpm run build && corepack pnpm start"
     environment:
+      CORS_ORIGINS: "https://iwanttoheal.phenomrom.com,capacitor://localhost,http://localhost"
+      DATA_DIR: /app/data
       HOST: 0.0.0.0
       PORT: "4173"
     init: true
@@ -82,11 +98,21 @@ services:
     restart: unless-stopped
     volumes:
       - /mnt/usbssds/apps/iwanttoheal-mmo/app:/app
+      - /mnt/usbssds/apps/iwanttoheal-mmo/data:/app/data
     working_dir: /app
 ```
 
-This game has no server database. Do not add `db:init`, `/app/data`, cookie,
-CORS, or proxy environment settings from the older game.
+Do not remove the `/app/data` mount or place the SQLite database inside the source
+checkout. Back up `/mnt/usbssds/apps/iwanttoheal-mmo/data/game.db` before database
+migrations or destructive maintenance.
+
+From the app checkout, create a consistent SQLite backup with:
+
+```sh
+DATA_DIR=/mnt/usbssds/apps/iwanttoheal-mmo/data \
+BACKUP_DIR=/mnt/usbssds/apps/iwanttoheal-mmo/backups \
+corepack pnpm run db:backup
+```
 
 The separate volume protects the old app files and data. The YAML still maps
 host port `4173`, so the old and MMO apps cannot run simultaneously while both