server-management

# Server Management MobiSSH runs as a Docker container in production. Code changes require a container rebuild. ## Production: Docker container (`mobissh-prod`) The production server runs via `docker-compose.prod.yml` with built-in Tailscale. The container copies `public/` and `server/` at build time -- it does NOT hot-reload. ### Commands ```bash # Rebuild and deploy (after code changes) scripts/container-ctl.sh restart # Check status (health + code-currency check) scripts/container-ctl.sh status # Ensure current (idempotent: rebuilds only if stale) scripts/container-ctl.sh ensure # View logs docker logs mobissh-prod --tail 50 # Verify code is current docker exec mobissh-prod grep '<marker>' /app/public/native.html # Shell into container docker exec -it mobissh-prod sh ``` ### "My changes aren't showing" 1. Did you rebuild the container? (`scripts/container-ctl.sh restart`) — the image COPYs `public/` and `server/` at build time. 2. Is the container serving HEAD? (`scripts/container-ctl.sh status`) 3. Verify: `docker exec mobissh-prod grep '<your change>' /app/server/index.js` There is no build step: #1205 retired the PWA's TypeScript sources, so `public/` is shipped verbatim. ## Local server `scripts/server-ctl.sh` manages a local Node.js process on port 8081. This is NOT used for user-facing testing — use the prod container. ```bash scripts/server-ctl.sh ensure # start or restart until healthy at HEAD scripts/server-ctl.sh status # health check + version gate scripts/server-ctl.sh start # start if not running scripts/server-ctl.sh stop # stop server scripts/server-ctl.sh restart # force restart ``` `scripts/server-ctl.sh ensure` is the local-server lifecycle; the prod container is `scripts/container-ctl.sh`. ## Environment Variables | Variable | Default | Purpose | |---|---|---| | `PORT` | 8081 | Server listen port | | `TS_AUTHKEY` | (none) | Tailscale auth key for container | | `TS_HOSTNAME` | mobissh | Tailscale hostname | | `TS_SERVE` | 1 | Enable tailscale serve (skips auth in container) | ## Test sshd container A separate Docker Compose file (`docker-compose.test.yml`) runs an sshd container for testing: ```bash docker compose -f docker-compose.test.yml up -d test-sshd # start test sshd on port 2222 ``` Note: test sshd is a simple container with no lifecycle script — raw `docker compose` is acceptable here.