Operations

CLI snippets

Use the Typer CLI for local control.

# run the server (FastAPI + scheduler)
openrsvp runserver

# fetch the root admin token
openrsvp admin-token

# rotate the root admin token
openrsvp rotate-admin-token

# seed fake data for demos
openrsvp seed-data --channels 4 --max-events 3 --max-rsvps 5

# force decay and optional vacuum
openrsvp decay --vacuum

# inspect or edit configuration (writes openrsvp.toml)
openrsvp config --show
openrsvp config --delete-grace-days-after-end 45

# rebuild + restart the Docker container & prune old images
openrsvp upgrade-container --dev --host-port 8008 --data-dir ~/OpenRSVP/data

# renew TLS certs for docker-compose prod
openrsvp renew-certs

Root admin is CLI-only and can view everything but never edits guest content. openrsvp upgrade-container mirrors the dev workflow end-to-end: git pull --ff-only, rebuild, replace the running container, and prune the previous image (disable pulling with --no-git-pull). Use openrsvp renew-certs to run certbot renew and reload nginx.

Roles at a glance

Agent responsibilities

Tokens represent capabilities. Rotate the root admin token with openrsvp rotate-admin-token whenever you refresh server credentials.