Environment Variables

All environment variables that AImetier uses for server configuration.

Server Configuration

Variable	Default	Description
PORT	3100	Server port
AIMETIER_BIND	loopback	Reachability preset: loopback, lan, or custom (tailnet disabled 2026-06-15 — use lan, or AIMETIER_TAILNET_BIND_HOST to bind an explicit address)
AIMETIER_BIND_HOST	(unset)	Required when AIMETIER_BIND=custom
HOST	127.0.0.1	Legacy host override; prefer AIMETIER_BIND for new setups
DATABASE_URL	(embedded)	PostgreSQL connection string
AIMETIER_HOME	~/.aimetier	Base directory for all AImetier data
AIMETIER_INSTANCE_ID	default	Instance identifier (for multiple local instances)
AIMETIER_DEPLOYMENT_MODE	local_trusted	Runtime mode override
AIMETIER_DEPLOYMENT_EXPOSURE	private	Exposure policy when deployment mode is authenticated
AIMETIER_API_URL	(auto-derived)	AImetier API base URL. When set externally (e.g., via Kubernetes ConfigMap, load balancer, or reverse proxy), the server preserves the value instead of deriving it from the listen host and port. Useful for deployments where the public-facing URL differs from the local bind address.

Secrets

Variable	Default	Description
AIMETIER_SECRETS_MASTER_KEY	(from file)	32-byte encryption key (base64/hex/raw)
AIMETIER_SECRETS_MASTER_KEY_FILE	~/.aimetier/.../secrets/master.key	Path to key file
AIMETIER_SECRETS_STRICT_MODE	false	Require secret refs for sensitive env vars

Agent Runtime (Injected into agent processes)

These are set automatically by the server when invoking agents:

Variable	Description
AIMETIER_AGENT_ID	Agent’s unique ID
AIMETIER_COMPANY_ID	Company ID
AIMETIER_API_URL	AImetier API base URL (inherits the server-level value; see Server Configuration above)
AIMETIER_API_KEY	Short-lived JWT for API auth
AIMETIER_RUN_ID	Current heartbeat run ID
AIMETIER_TASK_ID	Issue that triggered this wake
AIMETIER_WAKE_REASON	Wake trigger reason
AIMETIER_WAKE_COMMENT_ID	Comment that triggered this wake
AIMETIER_APPROVAL_ID	Resolved approval ID
AIMETIER_APPROVAL_STATUS	Approval decision
AIMETIER_LINKED_ISSUE_IDS	Comma-separated linked issue IDs

LLM Provider Keys (for adapters)

Variable	Description
ANTHROPIC_API_KEY	Anthropic API key (for Claude Local adapter)
OPENAI_API_KEY	OpenAI API key (for Codex Local adapter)