skills.rest
jovermier
jovermierCOMMUNITY
Explore all skills by this author →
Website𝕏@jrovermierGitHub

convex-self-hosting

Deploy and operate a self-hosted Convex backend with Docker and authentication.

1|Updated Jan 12, 2026
Search Tags:#deployment#Docker#authentication#PostgreSQL#environment-variables#Convex#self-hosting
One-click install
npx skills add https://github.com/jovermier/claude-code-plugins-ip-labs --skill convex-self-hosting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-self-hosting
Source: https://github.com/jovermier/claude-code-plugins-ip-labs/tree/main/plugins/convex/skills/convex-self-hosting
Command: npx skills add https://github.com/jovermier/claude-code-plugins-ip-labs --skill convex-self-hosting

SYSTEM DOCUMENTATION & REQUIREMENTS

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

Frequently Asked Questions about convex-self-hosting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I self-host a Convex backend using Docker?▼

To self-host a Convex backend, clone the convex-backend repository, navigate to the self-hosted directory, run docker compose up, and execute the admin key generation script to configure your deployment environment.

How do I configure authentication for a self-hosted Convex deployment?▼

Authentication setup involves configuring @convex-dev/auth with JWT keys, JWKS, and issuer settings to ensure secure user sign-in for your self-hosted Convex backend environment.

What environment variables do I need for a production-ready Convex self-hosting setup?▼

Production-ready Convex self-hosting requires setting CONVEX_SELF_HOSTED_URL and CONVEX_SELF_HOSTED_ADMIN_KEY environment variables, alongside database and storage configurations for secure, scalable operations.

Does self-hosting Convex require PostgreSQL as its database?▼

PostgreSQL is used for database setup in a self-hosted Convex backend deployment, providing the necessary storage layer and data persistence required for production environments.

What is the best way to deploy code to a self-hosted Convex instance?▼

After configuring your self-hosted URL and admin key environment variables, deploy your application code directly to the Convex backend using the npx convex deploy command.

What are the limitations of maintaining a self-hosted Convex backend?▼

Self-hosted Convex maintenance involves troubleshooting common operational issues, managing environment configurations, performing upgrades, and handling backups to ensure deployment reliability.

Related Skills

Explore More Software Engineering Skills→
ripgraphicsripgraphics

cloud-deployment-expert

Deploy applications to VPS infrastructure with Docker and SSL configuration.

Community
Advanced
vanitiesvanities
5

convex-quickstart

Provision a local Convex deployment and validate schema and types.

Community
Intermediate
get-convexget-convex
9

workos-convex-auth

Configure WorkOS AuthKit with Convex for sign-in, sign-out, and admin checks.

Official
Advanced
jovermierjovermier
1

coder-convex

Configure self-hosted Convex development in a Coder workspace with Docker.

Community
Advanced