Self-Hosting

Quick Start

The fastest way to get LynxPrompt running is with the provided docker-compose.selfhost.yml.

# .env
NEXTAUTH_SECRET=$(openssl rand -base64 32)
ADMIN_EMAIL=you@example.com
APP_URL=https://lynxprompt.yourcompany.com

docker compose -f docker-compose.selfhost.yml up -d

Environment Variables

All configuration is done through environment variables. Only NEXTAUTH_SECRET is strictly required.

Core

Database

Authentication

AI Features

Marketplace

Federation

Branding & Content

Out of the box, LynxPrompt supports passkeys and email magic links. Add OAuth providers or lock down registration as needed.

AI-powered blueprint editing and wizard assistance are opt-in.

ENABLE_AI=true
ANTHROPIC_API_KEY=sk-ant-...
AI_MODEL=claude-3-5-haiku-latest  # optional

White-label LynxPrompt for your organization.

APP_NAME=MyCompany Prompts
APP_LOGO_URL=https://cdn.mycompany.com/logo.svg
CONTACT_EMAIL=support@mycompany.com
STATUS_PAGE_URL=https://status.mycompany.com

The app name is used throughout the UI, in page titles, email templates, and OpenGraph metadata. The logo replaces the default LynxPrompt logo in the header and email templates.

LynxPrompt uses four Prisma clients, each with its own connection string. This allows flexible deployment topologies.

DATABASE_URL_APP=postgresql://...
DATABASE_URL_USERS=postgresql://...   # same
DATABASE_URL_BLOG=postgresql://...    # same
DATABASE_URL_SUPPORT=postgresql://... # same

DATABASE_URL_APP=postgresql://app-db/lynx
DATABASE_URL_USERS=postgresql://auth-db/users
DATABASE_URL_BLOG=postgresql://blog-db/blog
DATABASE_URL_SUPPORT=postgresql://sup-db/forum

The LynxPrompt CLI works with self-hosted instances. After installing the CLI, point it to your instance:

lynxp config set-url https://lynxprompt.yourcompany.com
lynxp login

This stores the API URL locally. All subsequent CLI commands (push, pull, sync) will target your self-hosted instance instead of the public service.

LynxPrompt works behind any reverse proxy (Nginx, Caddy, Traefik). However, if you use Cloudflare as a reverse proxy, there is an important caveat for the API.

# Cloudflare DNS records:
#
# lynxprompt.yourcompany.com  →  A  your-ip  (Proxied, orange cloud)
# api.lynxprompt.yourcompany.com  →  A  your-ip  (DNS only, grey cloud)
#
# Then configure your reverse proxy to serve both domains,
# pointing to the same LynxPrompt backend.
#
# The CLI defaults to https://api.lynxprompt.com for the
# public instance. For self-hosted, point the CLI:
lynxp config set-url https://api.lynxprompt.yourcompany.com

Federation connects independent LynxPrompt instances into a shared network. Users on any federated instance can discover and download blueprints published on other instances.

ENABLE_FEDERATION=true
FEDERATION_REGISTRY_URL=https://registry.lynxprompt.com

LynxPrompt exposes a health endpoint for monitoring and orchestration:

GET /api/health

# Healthy response (200):
{"status":"ok","db":"connected"}

# Unhealthy response (503):
{"status":"error","db":"disconnected"}

Use this endpoint in Docker health checks, Kubernetes liveness probes, or external monitoring tools like Uptime Kuma.

# Docker Compose healthcheck example
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"]
  interval: 30s
  timeout: 5s
  retries: 3

Next Steps