Docket Docs

Maintenance

Keep your local Docket instance healthy.

Local Maintenance

Backups

SQLite Database

The database lives at ./data/docket.db. Back it up regularly:

# Create a timestamped backup
cp data/docket.db "data/docket-backup-$(date +%Y%m%d).db"

Blob Storage

Blobs are stored in ./data/blobs/. Sync to an external drive or cloud:

rsync -av data/blobs/ /mnt/external/docket-blobs/

Updates

git pull origin main
npm install
npm run migrate
npm start

Monitoring

Health Endpoint

curl http://localhost:3000/health
curl http://localhost:3000/admin/health

Logs

Docket uses Pino. Logs are structured JSON by default. Use pino-pretty for readability:

npm start | npx pino-pretty

Disk Space

SQLite with WAL mode can grow. Vacuum periodically:

sqlite3 data/docket.db "VACUUM;"

On this page