Configuration reference
PULSE is configured through environment variables. This page lists the ones the backend reads, grouped by purpose. It names variables and describes their effect. It does not show values: secrets come from the secret store, and Runink TIDE’s operator projects the rest.
Command line
| Command | Meaning |
|---|---|
pulse-server serve | Starts the backend. |
--port, -p | The port to listen on. Defaults to PORT when set, otherwise 0, which picks a free port. |
Server
| Variable | Effect |
|---|---|
PORT | Default for --port. |
PULSE_WEB_DIR | Retired. The backend serves no web bundle and the image no longer sets this. The production CORS check still skips when it is non-empty, so leave it unset. PULSE ships as an Android and iOS app. |
CORS_ALLOWED_ORIGINS | Comma-separated origins allowed to call the API cross-origin. Unset means * outside production. In production it must be set to pinned origins with no wildcard, or the backend refuses to boot. Only an exact listed origin gets credentials. |
PULSE_ENV | production (any case) turns the insecure-configuration warnings into a refusal to start. TIDE’s k0s overlay sets it. No billing or plan behavior reads it. See Operations. |
PULSE_GRPC_REFLECTION | true turns on gRPC reflection. Off by default. For local work only. |
PULSE_RATE_RPS, PULSE_RATE_BURST | Per-caller rate limit, keyed by peer IP. Off unless PULSE_RATE_RPS is above zero. |
PULSE_PUBLIC_BASE_URL | The public https origin. The base of every sign-in redirect (/oauth/social/callback, /oauth/search-console/callback, /oauth/mail/callback), of the signed /media/ links Instagram fetches, and of absolute podcast-feed links. See Public address and redirects. |
APP_VERSION | The version stamped on log lines. |
FEATURED_MESSAGES_PATH | The file behind the featured-message strip. |
A2A_ORGANIZATION | The organization named on the A2A agent card. Falls back to RUNINK_ORG, then TIDE_GITHUB_ORG, then empty. |
SELF_HEAL_AUTONOMOUS | false (or another no) turns automatic self-healing remediation off; plans are still recorded. Default: on. See Operations. |
Security
| Variable | Effect |
|---|---|
PULSE_JWT_SECRET | Required. The key that signs and verifies every session. There is no default. It must never be a value that has been committed anywhere. |
TIDE_ENVELOPE_KEK | Required. The key that seals OAuth tokens in the database. The database refuses to open without it. |
SECRET_BACKEND | Where secrets are read from. file reads each one from SECRETS_DIR/<name>; any other value reads the process environment. |
SECRETS_DIR | The directory the file backend reads. Default /var/run/secrets. |
PULSE_TLS_CERT, PULSE_TLS_KEY | In-process TLS for direct exposure. Set both or neither. TLS 1.2 minimum, forward-secret AEAD suites only. |
MESH_MTLS | true requires mutual TLS on the listener, with rotating certificates from the shared mesh CA. Takes precedence over PULSE_TLS_*. TLS 1.3 only. |
MESH_CA_CERT, MESH_CA_KEY | The mesh CA, from the secret store. Needed when MESH_MTLS=true. |
MESH_ISSUER_URL, MESH_ISSUER_TOKEN_FILE | The preferred mesh identity: the pod makes its own key and enrols it with TIDE’s mesh issuer, authenticated by the projected ServiceAccount token in the file. MESH_CA_CERT is then only the trust bundle and MESH_CA_KEY is not read. Without MESH_ISSUER_URL, the older shared-CA path (MESH_CA_CERT + MESH_CA_KEY) still works and logs an error on every start. |
MESH_ADVERTISE_IP, MESH_ADVERTISE_HOST | Extra IP and DNS names on the mesh certificate. |
LICENSE, LICENSE_FILE, LICENSE_PUBLIC_KEY | An offline licence, inline or as a file, and the key that verifies it. With no licence there is no gating. |
Sign-in and users
| Variable | Effect |
|---|---|
PULSE_ADMIN_PASSWORD (or ADMIN_PASSWORD) | Seeds the break-glass admin. Without it, no password login exists. |
PULSE_ADMIN_USERNAME, PULSE_ADMIN_EMAIL | Overrides the break-glass admin’s username (admin) and email. |
GOOGLE_CLIENT_ID | The Google OAuth client. Without it, Google sign-in is off. |
OIDC_ISSUER | Overrides the token issuer that Google sign-in trusts. |
AUTH_GOOGLE_ONLY | true hides the password form. |
AUTH_ALLOWED_EMAILS | The Google sign-in allowlist. Empty means nobody signs in with Google. |
AUTH_SEED_USERS | Operator-granted roles as email=persona,…. Applied at every start. |
PULSE_CLIENT_INSTANCE, PULSE_CLIENT_INSTANCE_NAMESPACE | The ClientInstance this deployment is. Lets the Admin page write member changes back to it. |
GOOGLE_CLIENT_SECRET | The Google OAuth client’s secret: Connect with YouTube, Search Console and Gmail, and token refresh. See Google. |
GOOGLE_TOKEN_ENDPOINT | Overrides Google’s token endpoint (tests). |
See Users and access.
Storage
| Variable | Effect |
|---|---|
PULSE_DATA_DIR | Scratch directory (renders, clones). Nothing durable is kept there. Default ./data. |
PULSE_APPFS_BUCKET | Bucket of the sealed app root on the object store: every table, account, session and media file. Default pulse; the pulse operator sets it. |
PULSE_APPFS_DIR | Local sealed app root when there is no object store. Default $PULSE_DATA_DIR/appfs. |
OBJECTSTORE_ENDPOINT, OBJECTSTORE_ACCESS_KEY, OBJECTSTORE_SECRET_KEY | The object store the app root is mounted on (the in-cluster objectd). |
OBJECTSTORE_BUCKET | The grounding corpus bucket (pulse-corpus). |
Inference
| Variable | Effect |
|---|---|
INFERENCE_REMOTE_URL | Use the shared inference plane at this address: in the cluster, the model router, http://model-router.inference.svc.cluster.local:8080. Unset means PULSE starts its own mistralrs-server. |
INFERENCE_MODEL | The model name PULSE asks the inference plane for. Unset, it uses the code default, Qwen3-14B-Q4_K_M.gguf, which is also the platform inference library’s own default, so a locally managed engine loads the model PULSE then requests. In a cluster the name is only a label: the model router rewrites a general-tier request to the tier’s model. |
INFERENCE_API_KEY | Key for the inference server. |
INFERENCE_HOST, INFERENCE_IP, INFERENCE_PORT, MISTRAL_PORT | Where a local inference child listens. |
BINARY_MISTRALRS_SERVER, MODEL_DIR, PULSE_AGENT_CONFIG | The local engine binary, the model directory, and the agent config (default ./agents/pulse.ini). |
VOXTRAL_REMOTE_URL | The speech-to-text server. |
MODEL_VISION, VISION_REMOTE_URL | The vision tier that describes photos and video frames attached to an audit: the model id sent (default vision, which the model router routes to its vision tier; off turns it off) and the plane to send it to (default INFERENCE_REMOTE_URL). Without a remote plane there is no vision tier, and attached photos are marked “image understanding unavailable”. |
TTSD_URL | TIDE’s shared text-to-speech service, as a full URL. Unset means the in-cluster ttsd Service; set to empty turns voice output off. |
TTSD_CALLER_KEY_FILE | The file holding PULSE’s service key for ttsd. Read on every call, so a rotated key needs no restart. |
INFERENCE_DECODE_TOK_S | The platform decode rate that generation budgets are sized from. TIDE injects it. |
PULSE_FIRST_TOKEN_SECONDS | Wait allowed for the first token. Default 5 minutes. |
PULSE_GENERATION_TIMEOUT_SECONDS | Overrides the decode budget outright. |
PULSE_ADMIT_MAX, PULSE_ADMIT_QUEUE, PULSE_ADMIT_MODE, PULSE_ADMIT_WEIGHTS | In-process admission control. Off unless PULSE_ADMIT_MAX is above zero. |
PULSE_GATE_MAX_INFLIGHT, PULSE_GATE_FIRST_TOKEN_SECONDS, PULSE_GATE_DECODE_RATE | Cross-app admission gate for the shared plane: concurrent submissions (unset means unbounded), the longest acceptable queue wait, and the measured decode rate the wait is sized from. Off unless one is set. |
PULSE_DEDUP_TTL | How long a repeated generation is reused. Go duration, default 1h. |
PULSE_JUDGEMENT | off disables the judging ladder. |
PULSE_AUDIT_DEADLINE_SECONDS | The end-to-end deadline of the diagnostic and the site audit. Default 170, a three-minute budget less the time to render the result. Clamped to 10–900. Every phase’s budget is derived from what is left of it; a phase that does not finish shows on the reasoning card as “not completed within the 3-minute budget” and the result says it is partial. |
PULSE_BRAIN_MAX_SEQS | The brain tier’s --max-seqs. Default 2. Bounds how many judge claims run at once. |
INFERENCE_PREFILL_TOK_S, INFERENCE_PREFILL_EXPONENT | The plane’s prefill curve. The diagnostic trims its prompt to what its phase can prefill. Set from a benchmark of the target hardware. |
PULSE_RERANKER | off ranks the prompt’s context lexically instead of asking the reranker tier (reranker through the model router). |
PULSE_EGRESS_ALL_AGENTS | Widens output screening to every agent. Screened answers arrive whole instead of streaming. |
PULSE_SKILLS_MODELS | A TOML file of per-skill sampling settings, read on top of the built-in models.toml. When set it must be readable and valid, or the server does not start. |
PULSE_SEARCH_MIN_GAP_MS | The least time between two web searches, in milliseconds. Default 2500. |
TIDE_HEALTH_URL | Where agent health reports go. Unset means no reports. |
See Sovereign inference.
Connections
Each person connects their own accounts under Settings › Integrations. These are the instance’s app clients that make one-click sign-in possible; all are secrets from the instance’s secret store.
| Variable | Effect |
|---|---|
META_APP_ID, META_APP_SECRET | Connect with Instagram. See Meta. |
LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET | Connect with LinkedIn. See LinkedIn. |
LINKEDIN_COMPANY_PAGES | true once LinkedIn approved the Community Management API: offers company pages. |
MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID | Connect Microsoft 365 (tenant default common). See Email. |
GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET (under Sign-in) serve YouTube,
Search Console and Gmail too.
Site audit and scoring
| Variable | Effect |
|---|---|
PULSE_SCORING_CONFIG | A JSON file overlaid on the built-in scoring config. |
PULSE_AUDIT_CACHE_TTL | How long an audit result is cached, in seconds. Default 3600. |
PULSE_PROSPECT_AUDIT_TIMEOUT | Time limit for auditing one prospect’s site during lead prospecting. Go duration, for example 20s. |
PULSE_SITE_AUDIT_URL | The site the daily audit engine checks. Falls back to PULSE_SITE_BASE_URL. The engine also needs PULSE_APPLY_ENABLED=true before it starts. |
Publishing
| Variable | Effect |
|---|---|
PULSE_APPLY_ENABLED | The global kill switch. Only the exact value true arms anything. |
PULSE_PUBLISH_<CHANNEL> | Narrows one channel: BLOG, PODCAST, AUDIOBOOK, YOUTUBE, INSTAGRAM, SPOTIFY, LINKEDIN, EMAIL, WHATSAPP, SMS, and the reply keys LINKEDIN_REPLIES, INSTAGRAM_REPLIES, INSTAGRAM_DMS, YOUTUBE_REPLIES. |
PULSE_PUBLISH_AUTOMATIONS | Lets automations do outbound work. Off by default. |
PULSE_EMAIL_DAILY_LIMIT | Emails one person may send per 24 hours. Default 50. |
PULSE_OPPORTUNITIES_DISCOVERY | The daily read of open procurement data. On by default. |
PULSE_PUBLISH_CONFIG_PATH, PULSE_PUBLISH_CONFIG_JSON | The per-channel arming file, or the same JSON inline. |
PULSE_PUBLISHER_USER_IDS | Comma-separated PULSE user ids allowed to publish through the deployment-global channels (LinkedIn, blog, podcast, audiobook). Empty means nobody. |
PULSE_AUDIT_APPLY | Arms the audit-fix modes of ApplyAuditActions (apply/commit/pr), on top of PULSE_APPLY_ENABLED=true. Off unless an explicit yes. Admins only. |
PULSE_APPLY_ROOT | The only directory an audit-fix repo_path may resolve into. Unset refuses every mode, plan included. |
PULSE_SITE_REPO, PULSE_SITE_BRANCH, PULSE_SITE_BLOG_DIR, PULSE_SITE_PUBLISH_MODE, PULSE_SITE_AUTHOR, PULSE_SITE_BASE_URL | Blog publishing to your website. |
PULSE_GIT_AUTHOR_NAME, PULSE_GIT_AUTHOR_EMAIL | The author on commits PULSE makes. |
YOUTUBE_PRIVACY_STATUS | public, unlisted, or private. Unset means private. |
LINKEDIN_ACCESS_TOKEN, LINKEDIN_AUTHOR_URN, LINKEDIN_API_VERSION | The deployment’s LinkedIn token (from a secret) and author (person or organization URN), used only for a user with no LinkedIn connection; and the API version header. |
LINKEDIN_API_BASE | Overrides LinkedIn’s API base (tests). |
PULSE_LINKEDIN_CTA_URL | The link the daily LinkedIn draft ends with. Default https://runink.org. |
PULSE_PODCAST_TITLE, PULSE_PODCAST_DESCRIPTION, PULSE_PODCAST_LANGUAGE | Podcast feed metadata. |
The defaults and the safe order to turn these on are on Switches and arming order. See Publishing controls and Site pipeline.
Media
| Variable | Effect |
|---|---|
BINARY_VIDEO_CLI | The local prompt-to-video tool (default ./agents/bin/video-gen) behind three things only: course module videos, a video creative asked for through the API (GenerateCreative), and the engine that makes YouTube Shorts on its own every day. Without it course modules are saved with no video and say so, the creative says the tool is not available, and that daily engine stays off (one log line at start). Studio does not use it: asked for a video, it makes a YouTube Short. Reels, Stories and YouTube Shorts are drawn in Go and assembled with ffmpeg, and YouTube’s readiness in Settings › Integrations depends on ffmpeg. |
VIDEO_MODEL_DIR | Model directory for video generation. |
FFMPEG_PATH | Overrides the ffmpeg binary. |
ORPHEUS_BACKEND | The compute backend passed to the video tool. Default vulkan. |
Telephony and messaging
| Variable | Effect |
|---|---|
PULSE_OUTBOUND_CALLS | One of the switches an AI call needs (with PULSE_AI_CALLS). Off by default. Callers must also be editor or admin. |
CALLING_AGENT_URL | The platform calling agent that carries browser voice calls. |
PULSE_WEBRTC_SIGNALING_ONLY | true answers WebRTC offers locally for signaling tests. Such a call cannot hear the caller. |
TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN | The carrier account behind WhatsApp, SMS and Send / Call. Both are secrets. |
TWILIO_WHATSAPP_FROM, TWILIO_FROM_NUMBER, TWILIO_VOICE_FROM | The WhatsApp sender, the SMS number, and the number calls are placed from. TWILIO_VOICE_FROM is optional and falls back to TWILIO_FROM_NUMBER. |
PULSE_WHATSAPP_USER_ID | Which user’s HubSpot connection backs the WhatsApp sender allowlist, and as whom replies run. |
PULSE_WHATSAPP_AUTOREPLY | true turns automatic WhatsApp/SMS replies on; they also need PULSE_APPLY_ENABLED=true and PULSE_PUBLISH_WHATSAPP / PULSE_PUBLISH_SMS. Default: off. |
Billing and tenancy
| Variable | Effect |
|---|---|
TENANT_ID | This deployment’s tenant. |
SUBSCRIPTION_TIER, SUBSCRIPTION_SEATS, SUBSCRIPTION_STATUS | The subscription the Billing page shows. |
SUBSCRIPTION_PERIOD_END, SUBSCRIPTION_ANNUAL | The current billing period’s end (RFC 3339) and whether the subscription is yearly. |
RUNINK_ACCOUNTS_FILE | The member-to-purchaser file TIDE’s operator projects. Each signed-in person’s plan and seats come from the purchaser it names. |
RUNINK_USAGE_* | The usage bucket TIDE’s operator gives the pod. It holds the trial’s daily task count. |
TIDE_ROUTER_BILLING_KEY_FILE, TIDE_ROUTER_BILLING_KID | The service key file and key id PULSE signs its model-router billing claim with. Unset, model calls carry no claim and the router treats them as spot work. |
Usage is kept on the object store configured under Storage. See Billing and Plans.
Names that are no longer read
Some variables of earlier releases are read by nothing now. Setting one does
nothing, and PULSE does not warn: a deployment that still sets only an old
model variable runs on the default model. The list is under
Old names and addresses. Use
INFERENCE_MODEL, INFERENCE_REMOTE_URL and TTSD_URL.