Skip to content

Runtime configuration ​

Lisa is configured through environment variables. Runtime data is stored in Lisa-owned PostgreSQL and filesystem roots with no required TheLake dependency.

VariablePurpose
LISA_WORKSPACE_IDUUID scope for one Lisa runtime deployment.
LISA_DATABASE_URLPostgreSQL writer connection used by Lisa's app and workers.
LISA_DATABASE_READ_URLRead-only PostgreSQL connection used by the Lisa database tool.
LISA_DATABASE_PROVISION_URLDeployment-only administrator connection used by scripts/provision_lisa.py.
LISA_DATABASE_WRITER_PASSWORD / LISA_DATABASE_READER_PASSWORDProvision runtime database roles.
LISA_SERVICE_TOKENBearer token for authenticated internal API routes.
LISA_MODELChat model identifier (defaults to gemini/gemini-3.8-flash).
GOOGLE_API_KEY / GEMINI_API_KEYGemini access for chat and policy judgments.
OPENAI_API_KEYOpenAI policy triage access.
GEMINI_MODEL_NAMEJudge model (defaults to gemini-3.8-flash).
LISA_DATA_DIRRoot for OpenHands and conversation state.
LISA_AGENT_WORKSPACE_ROOTRoot for pushed OTLP session bundles.
LISA_MAX_SESSION_TRACE_BYTESMaximum body size for pushed session traces (defaults to 16 MiB, max 64 MiB).
LISA_CORS_ORIGINSComma-separated browser origins allowed by CORS.
LISA_OWNER_USER_IDSLisa actor IDs authorized to approve policy changes.
SOFTPROBE_ASSERTION_HMAC_SECRETHMAC key for signed workspace assertions when enabled.
LISA_SLACK_*Optional Slack event and notification configuration.
LISA_STATIC_DIRFrontend bundle directory (defaults to /app/static in the image).

WARNING

POST /internal/v1/session-traces is unauthenticated and must remain on a private network. Do not expose it through public ingress.

Arex · Blackbox · Lisa