Environment Variables

The quickstart writes a .env file next to docker-compose.yml. Docker Compose reads it and passes selected values into Placet and Facio containers.

Quickstart stack variables

Variable	Used by	Meaning
`COMPOSE_PROFILES`	Docker Compose	`bundle` starts bundled Placet; empty means external Placet mode.
`PLACET_TAG`	Placet image	Image tag for bundled Placet.
`FACIO_TAG`	Facio image	Image tag for Facio.
`PLACET_PORT`	Placet	Host port for bundled Placet, default `8080`.
`JWT_SECRET`	Placet	Placet auth/session secret.
`PLACET_API_KEY`	Placet and Facio	Shared API key Facio uses to register/send to Placet.
`INITIAL_USER_EMAIL`	Placet	Initial bundled Placet user.
`INITIAL_USER_PASSWORD`	Placet	Initial bundled Placet password.
`APP_URL`, `NEXT_PUBLIC_WS_URL`, `NEXT_PUBLIC_APP_URL`	Placet	Public URLs for bundled Placet.
`FACIO_REPLICAS`	Helper	Desired number of Facio agents for `./facio scale`.

Facio-Placet variables

Variable	Config target	Meaning
`FACIO_PLACET_INSTANCE_URL`	`channels.placet.instanceUrl`	Placet base URL. Auto-enables Placet channel when set.
`FACIO_PLACET_API_KEY`	`channels.placet.apiKey`	API key for Placet. Quickstart maps from `PLACET_API_KEY`.
`FACIO_PLACET_AGENT_ID`	`channels.placet.agentId`	Optional stable agent ID.
`FACIO_AGENT_NAME`	Compose command	Visible agent name fallback.
`FACIO_PLACET_AGENT_NAME`	`channels.placet.agentName`	Visible Placet name.
`FACIO_PLACET_CHANNEL_TAG`	`channels.placet.channelTag`	Optional tag in Placet.
`FACIO_MANAGEMENT_URL`	`channels.placet.managementPublicUrl`	URL Placet uses to call Facio management API.
`FACIO_MANAGEMENT_TOKEN`	`api.managementToken` and Placet channel	Bearer token for `/api/v1/*`; announced to Placet.

Provider variables

The quickstart maps a small common set directly:

Variable	Config target
`OPENROUTER_API_KEY`	`providers.openrouter.apiKey` via `FACIO_PROVIDER_OPENROUTER_API_KEY`
`ANTHROPIC_API_KEY`	`providers.anthropic.apiKey` via `FACIO_PROVIDER_ANTHROPIC_API_KEY`
`OPENAI_API_KEY`	`providers.openai.apiKey` via `FACIO_PROVIDER_OPENAI_API_KEY`
`FACIO_PROVIDER_DEEPSEEK_API_KEY`	`providers.deepseek.apiKey`
`FACIO_PROVIDER_GEMINI_API_KEY`	`providers.gemini.apiKey`
`FACIO_PROVIDER_GROQ_API_KEY`	`providers.groq.apiKey`
`FACIO_MODEL`	`agents.defaults.model`
`FACIO_IMAGE_MODEL`	`agents.defaults.imageModel`
`FACIO_VIDEO_MODEL`	`agents.defaults.videoModel`
`FACIO_VISION_MODEL`	`agents.defaults.visionModel`
`FACIO_WORKSPACE`	`agents.defaults.workspace`

Other provider keys can be configured through Placet settings, config files, or the provider credential API.

API and security variables

Variable	Config target	Meaning
`FACIO_API_PORT`	`api.port`	HTTP API port.
`FACIO_MANAGEMENT_ENABLED`	`api.managementEnabled`	Enable management surface when token exists.
`FACIO_A2A_TOKEN`	`api.a2aToken`	Bearer token for A2A.
`FACIO_A2A_ENABLED`	`api.a2aEnabled`	Enable A2A and agent card.
`FACIO_ALLOWED_ORIGINS`	`api.allowedOrigins`	Comma-separated CORS allow list.
`FACIO_RATE_LIMIT_RPM`	`api.rateLimitRpm`	Per-client-IP request limit.
`FACIO_EXEC_SANDBOX`	`tools.exec.sandbox`	`bwrap` by default; set empty only when intentionally disabling sandboxing.

Browser variables

Variable	Config target
`FACIO_BROWSER_ENABLED`	`tools.browser.enable`
`FACIO_BROWSER_BACKEND`	`tools.browser.backend`
`FACIO_BROWSER_COMMAND_TIMEOUT`	`tools.browser.commandTimeout`
`FACIO_BROWSER_INACTIVITY_TIMEOUT`	`tools.browser.inactivityTimeout`
`FACIO_BROWSER_MAX_CONCURRENT_SESSIONS`	`tools.browser.maxConcurrentSessions`
`FACIO_BROWSER_MAX_NAMED_SESSIONS`	`tools.browser.maxNamedSessions`
`FACIO_BROWSER_PROFILE_KEY`	`tools.browser.profileMasterPassword`
`FACIO_BROWSER_ALLOW_PRIVATE_URLS`	`tools.browser.allowPrivateUrls`
`FACIO_BROWSER_DOMAIN_ALLOWLIST`	`tools.browser.domainAllowlist`
`FACIO_BROWSER_DOMAIN_DENYLIST`	`tools.browser.domainDenylist`
`FACIO_BROWSER_RECORD_SESSIONS`	`tools.browser.recordSessions`
`FACIO_BROWSER_PROXY`	`tools.browser.proxy`
`FACIO_BROWSER_USER_AGENT`	`tools.browser.userAgent`
`FACIO_BROWSER_CAMOUFOX_FINGERPRINT_FILE`	`tools.browser.camoufox.fingerprintFile`

Use .env for deployment-time values and tokens needed at startup. Use Placet settings or the management API for runtime changes, especially provider keys, model selection, MCP, channels, and browser/tool settings.