convex-self-hosting
CommunitySelf-host Convex deployments with confidence.
System Documentation
What problem does it solve?
This skill guides teams through deploying and maintaining a self-hosted Convex backend, including authentication setup, environment configuration, and production-readiness considerations.
Core Features & Use Cases
- Docker-based deployment guidance: Set up the Convex backend locally or in a containerized environment.
- Authentication integration: Configure @convex-dev/auth with JWT keys, JWKS, and issuer settings for secure sign-in.
- Environment & production readiness: Provide environment variable recipes, database setup (PostgreSQL), storage options, and security best practices for production deployments.
- Troubleshooting & maintenance: Operational guidance for common issues, upgrades, and backups.
Quick Start
Clone the Convex self-hosted repo and spin up the stack: git clone https://github.com/get-convex/convex-backend cd convex-backend/self-hosted docker compose up docker compose exec backend ./generate_admin_key.sh
Configure environment: export CONVEX_SELF_HOSTED_URL=http://127.0.0.1:3210 export CONVEX_SELF_HOSTED_ADMIN_KEY=<your-key>
Deploy your code: npx convex deploy
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: convex-self-hosting Download link: https://github.com/jovermier/claude-code-plugins-ip-labs/archive/main.zip#convex-self-hosting Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.