---

name: deployment description: Helps with deploying OSD packages to sych.local. Use when discussing deployment, hot-reload, frontend updates, or gallery updates. allowed-tools: Read, Bash, Glob, Grep

Deployment

Assists with deploying OSD packages to the sych.local server.

Deployment Targets

Use make from anywhere (host or container):

Full Deploy (Frontend + Gallery)

Copy# Dev builds (recommended for development)
make deploy

# Production builds (optimized)
make deploy-prod

Selective Deploy

Copymake deploy-frontend   # Live variants only (live_day + live_thermal)
make deploy-gallery    # Recording variant only (recording_day)

What Gets Deployed

Location: sych.local:/home/archer/web/osd/

Hot-Reload Workflow

1. Make changes to OSD source
2. Run make deploy (or ./tools/devcontainer-build.sh deploy)
3. Frontend auto-detects package changes via ETag
4. Worker reloads within ~1 second

Configuration

Environment variables in .env:

CopyDEPLOY_HOST=sych.local
DEPLOY_USER=archer

PiP Override

The resources/pip_override.json disables all widgets except crosshair for Picture-in-Picture views:

Copy{
  "variant_info": { "enabled": false },
  "speed_indicators": { "enabled": false },
  "timestamp": { "enabled": false },
  "navball": { "enabled": false },
  "celestial_indicators": { "enabled": false }
}

Package Sizes

Dev packages include debug symbols for easier troubleshooting.