zoneless/.env.example at main · zonelessdev/zoneless · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# Zoneless Development Configuration
# All values have sensible defaults — an empty .env file works for local dev.
#
# For production / self-hosting with Docker, see .env.production.example

# Port the dashboard is served on (also used to generate links).
# In Docker, this maps the container's port 80 to your host.
DASHBOARD_PORT=

# Optional full URL override for the dashboard.
# Only needed for custom domains — auto-derived from DASHBOARD_PORT if unset.
DASHBOARD_URL=

# Optional dedicated checkout origin (e.g. https://checkout.zoneless.com).
# Leave empty to serve checkout from the dashboard URL at /c/:id.
# When set, session links use https://checkout…/c/:id (same path either way).
CHECKOUT_URL=

# Optional dedicated payment-link origin (e.g. https://pay.zoneless.com).
# Leave empty to use CHECKOUT_URL (or the dashboard URL) at /b/:id.
# When set, payment link URLs use https://pay…/b/:id.
PAYMENT_LINK_URL=

# MongoDB connection string.
# Leave empty for sensible defaults:
#   Local dev (npm run dev): mongodb://localhost:27017/zoneless?replicaSet=rs0
#   Docker (docker compose up): mongodb://mongodb:27017/zoneless?directConnection=true
MONGODB_URI=

# Port the API is served on.
API_PORT=

# Secret key for signing JWTs and encrypting data.
# Generate one with: openssl rand -hex 64
# If left empty, one is auto-generated and stored in the database.
APP_SECRET=

# Single-tenant mode: only one platform can be created (default: true).
# Set to false to allow multiple platforms.
SINGLE_TENANT=

# Operator mode (managed hosting): set a long random secret to enable.
# Generate one with: openssl rand -hex 32
# When set, public setup is disabled and platforms are provisioned via the
# /v1/operator API. Implies multi-tenant mode (SINGLE_TENANT is ignored).
OPERATOR_API_KEY=

# Solana RPC endpoint
# e.g. https://api.devnet.solana.com or a Helius/QuickNode URL
SOLANA_RPC_URL=

# LIVEMODE controls Solana network: false = devnet (test), true = mainnet (real USDC)
LIVEMODE=

# Base58 secret key that owns on-chain subscription plans and signs pulls.
# Required to create recurring prices. Existing plans must keep the same owner.
# SUBSCRIPTION_OPERATOR_KEY=

# Optional base58 secret key that sponsors Solana checkout network fees / rent.
# When set, buyers only co-sign; the API cosigns and broadcasts.
# When unset, buyers pay fees via wallet signAndSend.
# TRANSACTION_FEE_PAYER_KEY=

# Subscription billing: in-process poller (single-instance Docker / local only).
# Prefer POST /v1/billing/run_for_platform (platform API key) or, on managed
# hosting, POST /v1/billing/run with x-operator-key via cron / Cloud Scheduler.
# BILLING_MONITOR_ENABLED=false
# BILLING_POLL_INTERVAL_MS=60000

# Anonymous usage telemetry (opt-in via setup/settings; off by default).
# Set to 0 to force disable.
# ZONELESS_TELEMETRY=