Upgrade Guide

Standard Upgrade

Backup your data
Terminal window
```
./scripts/backup.sh --all
```
See Backup & Restore for details.
Pull the latest code
Terminal window
```
cd breeze
git pull origin main
```
Update dependencies
Terminal window
```
pnpm install
```
Re-deploy
Terminal window
```
./scripts/prod/deploy.sh .env.prod
```
The deploy script handles:
- Running any pending database migrations
- Rebuilding Docker images with the latest code
- Rolling restart of services
- Health check verification

Checking the Current Version

# API version
curl -s https://breeze.yourdomain.com/health | jq .version

# Agent version
breeze-agent version

Database Migrations

Migrations run automatically during deployment. To run them manually:

export DATABASE_URL="postgresql://breeze:password@localhost:5432/breeze"
pnpm db:migrate

Rolling Back

If an upgrade causes issues:

# Revert to the previous version
git checkout <previous-tag>
pnpm install
./scripts/prod/deploy.sh .env.prod

Agent Upgrades

Agents can be upgraded remotely from the dashboard or via command:

# From the API (sends upgrade command to agent via WebSocket)
curl -X POST https://breeze.yourdomain.com/api/v1/devices/:id/commands \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"action": "upgrade_agent", "payload": {"version": "0.2.0"}}'

The agent downloads the new binary, verifies its signature, and performs a self-upgrade with automatic rollback on failure.