Environment Variables

Complete reference for all environment variables used by Steadybase.

Required

These variables must be set for the server to start:

Variable	Description	Example
`PORT`	Express server port	`3000`

:::note If Temporal Cloud variables are not set, the server starts in demo mode with simulated workers and workflows. :::

Temporal Cloud

Required for live workflow execution:

Variable	Description	Example
`TEMPORAL_ADDRESS`	Temporal Cloud gRPC endpoint	`us-west-2.aws.api.temporal.io:7233`
`TEMPORAL_NAMESPACE`	Namespace identifier	`quickstart-steadybase.fwo3l`
`TEMPORAL_TASK_QUEUE`	Worker task queue name	`steadybase-gtm`
`TEMPORAL_TLS_CERT`	mTLS client certificate (Base64 or file path)	`/path/to/client.pem` or Base64 string
`TEMPORAL_TLS_KEY`	mTLS client private key (Base64 or file path)	`/path/to/client.key` or Base64 string

Certificate Formats

The TLS certificate and key can be provided in two formats:

# Option 1: File paths
TEMPORAL_TLS_CERT=/etc/steadybase/certs/client.pem
TEMPORAL_TLS_KEY=/etc/steadybase/certs/client.key
 
# Option 2: Base64-encoded strings
TEMPORAL_TLS_CERT=LS0tLS1CRUdJTi...
TEMPORAL_TLS_KEY=LS0tLS1CRUdJTi...

AI / LLM

Variable	Description	Required	Example
`CLAUDE_CLI_PATH`	Path to Claude CLI executable	For Brain API	`/usr/local/bin/claude`

:::info The Anthropic SDK is initialized via the @anthropic-ai/sdk package, which reads ANTHROPIC_API_KEY from the environment automatically. :::

Integrations

Variable	Description	Required For	Example
`VAPI_API_KEY`	VAPI API key for voice features	VAPI integration	`vapi-...`
`VAPI_ASSISTANT_ID`	VAPI assistant identifier	VAPI integration	`asst-...`
`SLACK_BOT_TOKEN`	Slack bot OAuth token	Slack notifications	`xoxb-...`
`SLACK_SIGNING_SECRET`	Slack request signing secret	Slack webhook verification	Secret string

Authentication (Future)

These variables exist in the codebase but are currently disabled (Cognito integration is not active):

Variable	Description	Status	Example
`COGNITO_USER_POOL_ID`	AWS Cognito user pool	Disabled	`us-west-2_XXXXXXXXX`
`COGNITO_CLIENT_ID`	Cognito app client ID	Disabled	Client ID string
`COGNITO_REGION`	AWS region for Cognito	Disabled	`us-west-2`

Experimental

Variable	Description	Status	Example
`LOCAL_LLM_URL`	URL for local LLM endpoint	Future	`http://100.x.x.x:8080/v1`

Security Best Practices

:::warning Never commit .env files to version control. Always use .env.example with placeholder values. :::

Set file permissions to 600 on .env files
Use AWS Secrets Manager for production deployments (Phase 2)
Rotate credentials regularly
Use separate credentials for development and production
Never log environment variable values

Example .env File

# Server
PORT=3000
 
# Temporal Cloud
TEMPORAL_ADDRESS=us-west-2.aws.api.temporal.io:7233
TEMPORAL_NAMESPACE=your-namespace
TEMPORAL_TASK_QUEUE=steadybase-gtm
TEMPORAL_TLS_CERT=/path/to/client.pem
TEMPORAL_TLS_KEY=/path/to/client.key
 
# AI
CLAUDE_CLI_PATH=/usr/local/bin/claude
 
# Integrations (optional)
VAPI_API_KEY=your-vapi-key
VAPI_ASSISTANT_ID=your-assistant-id
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-secret

Environment Variables

On this page