Skip to content
Configuration reference

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

CommandMeaning
pulse-server serveStarts the backend.
--port, -pThe port to listen on. Defaults to PORT when set, otherwise 0, which picks a free port.

Server

VariableEffect
PORTDefault for --port.
PULSE_WEB_DIRRetired. 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_ORIGINSComma-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_ENVproduction (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_REFLECTIONtrue turns on gRPC reflection. Off by default. For local work only.
PULSE_RATE_RPS, PULSE_RATE_BURSTPer-caller rate limit, keyed by peer IP. Off unless PULSE_RATE_RPS is above zero.
PULSE_PUBLIC_BASE_URLThe 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_VERSIONThe version stamped on log lines.
FEATURED_MESSAGES_PATHThe file behind the featured-message strip.
A2A_ORGANIZATIONThe organization named on the A2A agent card. Falls back to RUNINK_ORG, then TIDE_GITHUB_ORG, then empty.
SELF_HEAL_AUTONOMOUSfalse (or another no) turns automatic self-healing remediation off; plans are still recorded. Default: on. See Operations.

Security

VariableEffect
PULSE_JWT_SECRETRequired. 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_KEKRequired. The key that seals OAuth tokens in the database. The database refuses to open without it.
SECRET_BACKENDWhere secrets are read from. file reads each one from SECRETS_DIR/<name>; any other value reads the process environment.
SECRETS_DIRThe directory the file backend reads. Default /var/run/secrets.
PULSE_TLS_CERT, PULSE_TLS_KEYIn-process TLS for direct exposure. Set both or neither. TLS 1.2 minimum, forward-secret AEAD suites only.
MESH_MTLStrue 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_KEYThe mesh CA, from the secret store. Needed when MESH_MTLS=true.
MESH_ISSUER_URL, MESH_ISSUER_TOKEN_FILEThe 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_HOSTExtra IP and DNS names on the mesh certificate.
LICENSE, LICENSE_FILE, LICENSE_PUBLIC_KEYAn offline licence, inline or as a file, and the key that verifies it. With no licence there is no gating.

Sign-in and users

VariableEffect
PULSE_ADMIN_PASSWORD (or ADMIN_PASSWORD)Seeds the break-glass admin. Without it, no password login exists.
PULSE_ADMIN_USERNAME, PULSE_ADMIN_EMAILOverrides the break-glass admin’s username (admin) and email.
GOOGLE_CLIENT_IDThe Google OAuth client. Without it, Google sign-in is off.
OIDC_ISSUEROverrides the token issuer that Google sign-in trusts.
AUTH_GOOGLE_ONLYtrue hides the password form.
AUTH_ALLOWED_EMAILSThe Google sign-in allowlist. Empty means nobody signs in with Google.
AUTH_SEED_USERSOperator-granted roles as email=persona,…. Applied at every start.
PULSE_CLIENT_INSTANCE, PULSE_CLIENT_INSTANCE_NAMESPACEThe ClientInstance this deployment is. Lets the Admin page write member changes back to it.
GOOGLE_CLIENT_SECRETThe Google OAuth client’s secret: Connect with YouTube, Search Console and Gmail, and token refresh. See Google.
GOOGLE_TOKEN_ENDPOINTOverrides Google’s token endpoint (tests).

See Users and access.

Storage

VariableEffect
PULSE_DATA_DIRScratch directory (renders, clones). Nothing durable is kept there. Default ./data.
PULSE_APPFS_BUCKETBucket 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_DIRLocal sealed app root when there is no object store. Default $PULSE_DATA_DIR/appfs.
OBJECTSTORE_ENDPOINT, OBJECTSTORE_ACCESS_KEY, OBJECTSTORE_SECRET_KEYThe object store the app root is mounted on (the in-cluster objectd).
OBJECTSTORE_BUCKETThe grounding corpus bucket (pulse-corpus).

Inference

VariableEffect
INFERENCE_REMOTE_URLUse 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_MODELThe 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_KEYKey for the inference server.
INFERENCE_HOST, INFERENCE_IP, INFERENCE_PORT, MISTRAL_PORTWhere a local inference child listens.
BINARY_MISTRALRS_SERVER, MODEL_DIR, PULSE_AGENT_CONFIGThe local engine binary, the model directory, and the agent config (default ./agents/pulse.ini).
VOXTRAL_REMOTE_URLThe speech-to-text server.
MODEL_VISION, VISION_REMOTE_URLThe 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_URLTIDE’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_FILEThe file holding PULSE’s service key for ttsd. Read on every call, so a rotated key needs no restart.
INFERENCE_DECODE_TOK_SThe platform decode rate that generation budgets are sized from. TIDE injects it.
PULSE_FIRST_TOKEN_SECONDSWait allowed for the first token. Default 5 minutes.
PULSE_GENERATION_TIMEOUT_SECONDSOverrides the decode budget outright.
PULSE_ADMIT_MAX, PULSE_ADMIT_QUEUE, PULSE_ADMIT_MODE, PULSE_ADMIT_WEIGHTSIn-process admission control. Off unless PULSE_ADMIT_MAX is above zero.
PULSE_GATE_MAX_INFLIGHT, PULSE_GATE_FIRST_TOKEN_SECONDS, PULSE_GATE_DECODE_RATECross-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_TTLHow long a repeated generation is reused. Go duration, default 1h.
PULSE_JUDGEMENToff disables the judging ladder.
PULSE_AUDIT_DEADLINE_SECONDSThe 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_SEQSThe brain tier’s --max-seqs. Default 2. Bounds how many judge claims run at once.
INFERENCE_PREFILL_TOK_S, INFERENCE_PREFILL_EXPONENTThe plane’s prefill curve. The diagnostic trims its prompt to what its phase can prefill. Set from a benchmark of the target hardware.
PULSE_RERANKERoff ranks the prompt’s context lexically instead of asking the reranker tier (reranker through the model router).
PULSE_EGRESS_ALL_AGENTSWidens output screening to every agent. Screened answers arrive whole instead of streaming.
PULSE_SKILLS_MODELSA 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_MSThe least time between two web searches, in milliseconds. Default 2500.
TIDE_HEALTH_URLWhere 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.

VariableEffect
META_APP_ID, META_APP_SECRETConnect with Instagram. See Meta.
LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRETConnect with LinkedIn. See LinkedIn.
LINKEDIN_COMPANY_PAGEStrue once LinkedIn approved the Community Management API: offers company pages.
MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_IDConnect 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

VariableEffect
PULSE_SCORING_CONFIGA JSON file overlaid on the built-in scoring config.
PULSE_AUDIT_CACHE_TTLHow long an audit result is cached, in seconds. Default 3600.
PULSE_PROSPECT_AUDIT_TIMEOUTTime limit for auditing one prospect’s site during lead prospecting. Go duration, for example 20s.
PULSE_SITE_AUDIT_URLThe 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

VariableEffect
PULSE_APPLY_ENABLEDThe 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_AUTOMATIONSLets automations do outbound work. Off by default.
PULSE_EMAIL_DAILY_LIMITEmails one person may send per 24 hours. Default 50.
PULSE_OPPORTUNITIES_DISCOVERYThe daily read of open procurement data. On by default.
PULSE_PUBLISH_CONFIG_PATH, PULSE_PUBLISH_CONFIG_JSONThe per-channel arming file, or the same JSON inline.
PULSE_PUBLISHER_USER_IDSComma-separated PULSE user ids allowed to publish through the deployment-global channels (LinkedIn, blog, podcast, audiobook). Empty means nobody.
PULSE_AUDIT_APPLYArms 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_ROOTThe 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_URLBlog publishing to your website.
PULSE_GIT_AUTHOR_NAME, PULSE_GIT_AUTHOR_EMAILThe author on commits PULSE makes.
YOUTUBE_PRIVACY_STATUSpublic, unlisted, or private. Unset means private.
LINKEDIN_ACCESS_TOKEN, LINKEDIN_AUTHOR_URN, LINKEDIN_API_VERSIONThe 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_BASEOverrides LinkedIn’s API base (tests).
PULSE_LINKEDIN_CTA_URLThe link the daily LinkedIn draft ends with. Default https://runink.org.
PULSE_PODCAST_TITLE, PULSE_PODCAST_DESCRIPTION, PULSE_PODCAST_LANGUAGEPodcast 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

VariableEffect
BINARY_VIDEO_CLIThe 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_DIRModel directory for video generation.
FFMPEG_PATHOverrides the ffmpeg binary.
ORPHEUS_BACKENDThe compute backend passed to the video tool. Default vulkan.

Telephony and messaging

VariableEffect
PULSE_OUTBOUND_CALLSOne of the switches an AI call needs (with PULSE_AI_CALLS). Off by default. Callers must also be editor or admin.
CALLING_AGENT_URLThe platform calling agent that carries browser voice calls.
PULSE_WEBRTC_SIGNALING_ONLYtrue answers WebRTC offers locally for signaling tests. Such a call cannot hear the caller.
TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKENThe carrier account behind WhatsApp, SMS and Send / Call. Both are secrets.
TWILIO_WHATSAPP_FROM, TWILIO_FROM_NUMBER, TWILIO_VOICE_FROMThe 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_IDWhich user’s HubSpot connection backs the WhatsApp sender allowlist, and as whom replies run.
PULSE_WHATSAPP_AUTOREPLYtrue turns automatic WhatsApp/SMS replies on; they also need PULSE_APPLY_ENABLED=true and PULSE_PUBLISH_WHATSAPP / PULSE_PUBLISH_SMS. Default: off.

See Telephony and messaging.

Billing and tenancy

VariableEffect
TENANT_IDThis deployment’s tenant.
SUBSCRIPTION_TIER, SUBSCRIPTION_SEATS, SUBSCRIPTION_STATUSThe subscription the Billing page shows.
SUBSCRIPTION_PERIOD_END, SUBSCRIPTION_ANNUALThe current billing period’s end (RFC 3339) and whether the subscription is yearly.
RUNINK_ACCOUNTS_FILEThe 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_KIDThe 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.