0xsmw/vos

Node.js API

20 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow. (showing first 20, more exist in .env.example)

COMPOSE_PROJECT_NAME
VOS_VERSION
VOS_CADDY_SITE Public entrypoint. The default is HTTP-only catch-all for first boot. Set a real hostname such as apps.example.com to let Caddy request…
VOS_UPSTREAMS Caddy upstream list. Keep the default for one controller; use a space-separated list only after distinct regional origins and failover…
VOS_PUBLIC_URL
VOS_ROOT_DOMAIN
VOS_PRODUCTION_ROOT_DOMAIN
VOS_IMMUTABLE_ROOT_DOMAIN
VOS_PREVIEW_ROOT_DOMAIN
VOS_PULL_REQUEST_PREVIEW_ROOT_DOMAIN
VOS_CREATE_PULL_REQUEST_PREVIEW_ALIAS
VOS_DOMAIN_TLS_FRONT_DOOR_HOSTS
VOS_TLS_FRONT_DOOR_HOSTS
VOS_DOMAIN_DNS_TLS_APPLY Domain DNS/TLS provider apply is disabled unless this is 1 or true in the controller environment. Tokens alone must not trigger provider…
VOS_CUSTOMER_DOMAIN_CLOUDFLARE_PUSH_LIVE Customer-domain Cloudflare push-through helper gate. The helper also requires VOS_PUBLIC_URL, VOS_PROJECT, VOS_DOMAIN, VOS_ADMIN_TOKEN, the…
VOS_CLOUDFLARE_ZONE_NAME
VOS_CLOUDFLARE_ORIGIN_HOSTNAME
VOS_CLOUDFLARE_ACCOUNT_REF
VOS_CLOUDFLARE_ZONE_REF
VOS_DIGITALOCEAN_ORIGIN_REF

Best match Deploy on Railway Apps that need Postgres, Redis, or background workers.

Alternative Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/0xsmw/vos

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/0xsmw/vos

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/0xsmw/vos

Or deploy to a different host

Render Full-stack with managed Postgres + Redis. DigitalOcean App Platform Containers, droplets, and managed services.

← Try another repo