jac-sv-deploy

Deploy Jac servers to production with Kubernetes, databases, webhooks, and monitoring.

Updated Jul 26, 2026
One-click install
npx skills add https://github.com/PMN123/trapdoor --skill jac-sv-deploy-pmn123
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jac-sv-deploy
Source: https://github.com/PMN123/trapdoor/tree/main/.agents/skills/jac-sv-deploy
Command: npx skills add https://github.com/PMN123/trapdoor --skill jac-sv-deploy-pmn123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Moving a Jac server from local development to production involves many moving parts: database backends, secrets management, Kubernetes scaling, TLS, webhooks, WebSockets, file storage, and observability. This Skill consolidates the exact flags, config blocks, and pitfalls needed to run jac start and --scale deployments correctly. ## Core Features & Use Cases - Production server configuration: Covers jac start flags (--no-client, --faux, --profile prod), disabling Swagger docs, and choosing SQLite, MongoDB, or Redis backends with clear config precedence rules. - Kubernetes deployment: Documents jac start app.jac --scale, --dry-run validation, HPA autoscaling, TLS via cert-manager, jac scale status, and the destructive jac scale destroy. - External integrations: Explains webhook walkers with API-key plus HMAC-SHA256 auth, WebSocket walkers with broadcast, S3 file storage with presigned URLs, Prometheus metrics, and Redis distributed locks. - Use Case: You have a Jac app running locally on SQLite and need to ship it to a Kubernetes cluster with a custom domain, HTTPS, autoscaling, and a Stripe-style webhook callback. This Skill walks through the exact jac.toml blocks and commands, including the two-step TLS flow. ## Quick Start Ask the assistant to deploy your Jac app to Kubernetes with a custom domain, TLS, and autoscaling using the jac --scale workflow.

Frequently Asked Questions about jac-sv-deploy

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

FAQPage Schema
How do I deploy a Jac app to Kubernetes?▼

Run jac start app.jac --scale to deploy source directly into the cluster on a PVC without building an image. Always run with --dry-run first to lint config and catch errors like bad resource units or invalid HPA bounds before the full deploy.

How do I enable HTTPS for a Jac Kubernetes deployment?▼

HTTPS is a two-step process: first deploy plain with --scale and point your domain's CNAME at the printed NLB hostname, then run jac start app.jac --scale --enable-tls. cert-manager with Let's Encrypt patches the live ingress without a redeploy.

Can I run multiple Jac replicas with SQLite?▼

No. Multi-replica deployments with SQLite cause corruption and confusion. Going past one replica requires setting MONGODB_URI for the database and REDIS_URL for the cache tier and distributed locks.

How do Jac webhooks authenticate incoming requests?▼

Webhook walkers use API-key plus HMAC auth, not JWT. Create a key via POST /api-key/create, then callers send X-API-Key and X-Webhook-Signature, which is an HMAC-SHA256 of the raw body keyed by the API key.

Why does jac scale destroy delete my data?▼

jac scale destroy deletes the entire Kubernetes namespace including persistent volumes, so all data is lost permanently. There is a y/N confirmation prompt but no undo, so back up data before running it.

Why is my Jac webhook returning 404 on /walker/<name>?▼

Webhook walkers only answer on POST /webhook/<name>, not /walker/<name>, and regular walkers do the reverse. A 404 on the wrong path indicates a routing mismatch, not a registration failure.