Convex Self-Host

Use this skill to add Convex self-hosted backend and dashboard Docker Compose files to a project. Prefer the bundled script for repeatable setup.

Workflow

1. If the user names a project, pass it with --project-name.
2. If the user does not name a project, let the script derive it from the target directory basename.
3. Run the script from the target project directory, or pass --target-dir.
4. Use --start when the user wants Docker containers started now.
5. Use --generate-admin-key when the user wants .env.local populated with CONVEX_SELF_HOSTED_URL and CONVEX_SELF_HOSTED_ADMIN_KEY. This starts the containers if needed.

Script

Run:

python3 ~/.agents/skills/convex-self-host/scripts/setup_convex_self_host.py