# PentAGI Environment Variables ## Core runtime DEBUG=false ## DATA_DIR defaults to ./data (resolves to /opt/pentagi/data inside the image). DATA_DIR= ## Optional namespace for instances sharing external resources — one PostgreSQL, ## one worker node, one Neo4j/Graphiti, one Langfuse (empty = standalone instance). ## Must match ^[a-z][a-z0-9_]{0,31}$; invalid value aborts startup. ## NOT derived from it, set per instance yourself: DATA_DIR (sharing it overwrites ## flow data), DOCKER_PORTS_BASE, listen ports, INSTALLATION_ID. ## See backend/docs/config.md -> "Multi-Instance Deployment (TENANT_ID)". TENANT_ID= ## Base host port for per-flow sandbox port publishing (default 28000). ## Each instance owns [DOCKER_PORTS_BASE, DOCKER_PORTS_BASE+2000). DOCKER_PORTS_BASE= ## For communication with PentAGI Cloud API INSTALLATION_ID= LICENSE_KEY= ## Allow to interact with user while executing tasks ASK_USER= ## LLM Providers OPEN_AI_KEY= OPEN_AI_SERVER_URL=https://api.openai.com/v1 ANTHROPIC_API_KEY= ANTHROPIC_SERVER_URL=https://api.anthropic.com/v1 ## Google AI (Gemini) LLM provider GEMINI_API_KEY= GEMINI_SERVER_URL=https://generativelanguage.googleapis.com ## AWS Bedrock LLM provider BEDROCK_REGION=us-east-1 BEDROCK_DEFAULT_AUTH= BEDROCK_BEARER_TOKEN= BEDROCK_ACCESS_KEY_ID= BEDROCK_SECRET_ACCESS_KEY= BEDROCK_SESSION_TOKEN= BEDROCK_SERVER_URL= BEDROCK_CONFIG_PATH= ## DeepSeek LLM provider DEEPSEEK_API_KEY= DEEPSEEK_SERVER_URL=https://api.deepseek.com DEEPSEEK_PROVIDER= ## GLM (Zhipu AI) LLM provider GLM_API_KEY= GLM_SERVER_URL=https://api.z.ai/api/paas/v4 GLM_PROVIDER= ## Kimi (Moonshot) LLM provider KIMI_API_KEY= KIMI_SERVER_URL=https://api.moonshot.ai/v1 KIMI_PROVIDER= ## Qwen (Alibaba Cloud DashScope) LLM provider QWEN_API_KEY= QWEN_SERVER_URL=https://dashscope-us.aliyuncs.com/compatible-mode/v1 QWEN_PROVIDER= ## MiniMax LLM provider MINIMAX_API_KEY= MINIMAX_SERVER_URL=https://api.minimax.io/v1 MINIMAX_PROVIDER= ## Custom LLM provider LLM_SERVER_URL= LLM_SERVER_KEY= LLM_SERVER_MODEL= LLM_SERVER_PROVIDER= LLM_SERVER_CONFIG_PATH= LLM_SERVER_LEGACY_REASONING= LLM_SERVER_PRESERVE_REASONING= ## Ollama LLM provider (Local Server or Cloud) # Local: http://ollama-server:11434, Cloud: https://ollama.com OLLAMA_SERVER_URL= # Required for Ollama Cloud (https://ollama.com/settings/keys), leave empty for local OLLAMA_SERVER_API_KEY= OLLAMA_SERVER_MODEL= OLLAMA_SERVER_CONFIG_PATH= OLLAMA_SERVER_PULL_MODELS_TIMEOUT= OLLAMA_SERVER_PULL_MODELS_ENABLED= OLLAMA_SERVER_LOAD_MODELS_ENABLED= ## Embedding EMBEDDING_URL= EMBEDDING_KEY= EMBEDDING_MODEL= EMBEDDING_PROVIDER= EMBEDDING_BATCH_SIZE= EMBEDDING_MAX_TEXT_BYTES= EMBEDDING_STRIP_NEW_LINES= ## Summarizer SUMMARIZER_PRESERVE_LAST= SUMMARIZER_USE_QA= SUMMARIZER_SUM_MSG_HUMAN_IN_QA= SUMMARIZER_LAST_SEC_BYTES= SUMMARIZER_MAX_BP_BYTES= SUMMARIZER_MAX_QA_SECTIONS= SUMMARIZER_MAX_QA_BYTES= SUMMARIZER_KEEP_QA_SECTIONS= ## Assistant ASSISTANT_USE_AGENTS= ASSISTANT_SUMMARIZER_PRESERVE_LAST= ASSISTANT_SUMMARIZER_LAST_SEC_BYTES= ASSISTANT_SUMMARIZER_MAX_BP_BYTES= ASSISTANT_SUMMARIZER_MAX_QA_SECTIONS= ASSISTANT_SUMMARIZER_MAX_QA_BYTES= ASSISTANT_SUMMARIZER_KEEP_QA_SECTIONS= ## Execution Monitor Detector EXECUTION_MONITOR_ENABLED= EXECUTION_MONITOR_SAME_TOOL_LIMIT= EXECUTION_MONITOR_TOTAL_TOOL_LIMIT= ## Agent execution tool calls limit MAX_GENERAL_AGENT_TOOL_CALLS= MAX_LIMITED_AGENT_TOOL_CALLS= ## Agent planning step for pentester, coder, installer AGENT_PLANNING_STEP_ENABLED= ## HTTP proxy to use it in isolation environment PROXY_URL= ## SSL/TLS Certificate Configuration EXTERNAL_SSL_CA_PATH= EXTERNAL_SSL_INSECURE= ## HTTP client timeout in seconds for external API calls (LLM providers, search tools, etc.) ## Default: 600 (10 minutes). Set to 0 to use the default. HTTP_CLIENT_TIMEOUT= ## Default terminal tool timeout in seconds applied when an agent requests timeout=0 or a negative value. ## Default: 1200 (20 minutes). Range: 1–10800 (up to 3 hours). Values <= 0 or above 10800 are clamped to 10800 (agents always get a finite timeout). TERMINAL_TOOL_TIMEOUT= ## Scraper URLs and settings ## For Docker (default): SCRAPER_PUBLIC_URL= SCRAPER_PRIVATE_URL=https://someuser:somepass@scraper/ ## For Podman rootless, use: SCRAPER_PRIVATE_URL=http://someuser:somepass@scraper:3000/ ## See README.md "Running PentAGI with Podman" section for details LOCAL_SCRAPER_USERNAME=someuser LOCAL_SCRAPER_PASSWORD=somepass LOCAL_SCRAPER_MAX_CONCURRENT_SESSIONS=10 ## PentAGI server settings (docker-compose.yml) PENTAGI_LISTEN_IP= PENTAGI_LISTEN_PORT= PENTAGI_DATA_DIR= PENTAGI_SSL_DIR= PENTAGI_OLLAMA_DIR= PENTAGI_DOCKER_SOCKET= PENTAGI_DOCKER_CERT_PATH= PENTAGI_LLM_SERVER_CONFIG_PATH= PENTAGI_OLLAMA_SERVER_CONFIG_PATH= PENTAGI_BEDROCK_CONFIG_PATH= ## PentAGI security settings PUBLIC_URL=https://localhost:8443 CORS_ORIGINS=https://localhost:8443 COOKIE_SIGNING_SALT=salt # change this to improve security ## PentAGI internal server settings (inside the container) STATIC_DIR= STATIC_URL= SERVER_PORT=8443 SERVER_HOST=0.0.0.0 SERVER_SSL_CRT= SERVER_SSL_KEY= SERVER_USE_SSL=true ## Go pprof HTTP listener (empty = disabled). Use host:port, e.g. :7777. ## Instances sharing a host network need distinct addresses. PPROF_ADDR= ## OAuth google OAUTH_GOOGLE_CLIENT_ID= OAUTH_GOOGLE_CLIENT_SECRET= ## OAuth github OAUTH_GITHUB_CLIENT_ID= OAUTH_GITHUB_CLIENT_SECRET= ## DuckDuckGo search engine DUCKDUCKGO_ENABLED= DUCKDUCKGO_REGION= DUCKDUCKGO_SAFESEARCH= DUCKDUCKGO_TIME_RANGE= ## Sploitus search engine API SPLOITUS_ENABLED= ## Google search engine API GOOGLE_API_KEY= GOOGLE_CX_KEY= GOOGLE_LR_KEY= ## Traversaal search engine API TRAVERSAAL_API_KEY= ## Tavily search engine API TAVILY_API_KEY= ## Firecrawl search engine API ## FIRECRAWL_API_URL is optional; leave the default for the cloud API or point it at a self-hosted instance FIRECRAWL_API_KEY= FIRECRAWL_API_URL= ## Perplexity search engine API PERPLEXITY_API_KEY= PERPLEXITY_MODEL= PERPLEXITY_CONTEXT_SIZE= ## SEARXNG search engine API SEARXNG_URL= SEARXNG_CATEGORIES=general SEARXNG_LANGUAGE= SEARXNG_SAFESEARCH=0 SEARXNG_TIME_RANGE= SEARXNG_TIMEOUT= ## Web search internal analytics engine (optional fallback for the web_search tool) WEB_SEARCH_INTERNAL_ENABLED=false WEB_SEARCH_INTERNAL_MAX_SITES=5 WEB_SEARCH_INTERNAL_MAX_SITE_BYTES=10240 ## Langfuse observability settings LANGFUSE_BASE_URL= LANGFUSE_PROJECT_ID= LANGFUSE_PUBLIC_KEY= LANGFUSE_SECRET_KEY= ## OpenTelemetry observability settings OTEL_HOST= ## Docker client settings to run primary terminal container DOCKER_HOST= DOCKER_TLS_VERIFY= DOCKER_CERT_PATH= ## Docker settings inside primary terminal container # SECURITY NOTE: DOCKER_INSIDE=true mounts the host Docker socket into every # sandbox container so agents can launch sub-containers (Docker-in-Docker). # This grants any process inside the sandbox unrestricted access to the Docker # API, which can be exploited via prompt injection to escape the sandbox and # reach the host (issue #337). Only enable this when DinD is required and you # understand the risk. Consider using a least-privilege socket proxy such as # https://github.com/Tecnativa/docker-socket-proxy instead of the raw socket. DOCKER_INSIDE=false # enable to use docker socket (see security note above; default false) DOCKER_NET_ADMIN=true # enable to use net_admin capability DOCKER_SOCKET=/var/run/docker.sock # path on host machine ## Docker daemon the WORKER CONTAINER itself talks to (only used when DOCKER_INSIDE=true). ## Injected into the sandbox as DOCKER_HOST / DOCKER_TLS_VERIFY / DOCKER_CERT_PATH. ## Setting DOCKER_INSIDE_HOST also stops auto-detecting and mounting the host socket, ## so an agent reaches only the daemon you designate — unless DOCKER_SOCKET is set ## explicitly, which still takes precedence and is mounted as before. ## DOCKER_INSIDE_CERT_PATH is resolved on the WORKER NODE and bind-mounted read-only ## at the same path inside the container. DOCKER_INSIDE_HOST= DOCKER_INSIDE_TLS_VERIFY= DOCKER_INSIDE_CERT_PATH= DOCKER_NETWORK= DOCKER_WORK_DIR= DOCKER_PUBLIC_IP=0.0.0.0 # public ip of host machine DOCKER_DEFAULT_IMAGE= DOCKER_DEFAULT_IMAGE_FOR_PENTEST= # Postgres (pgvector) settings PENTAGI_POSTGRES_USER=postgres PENTAGI_POSTGRES_PASSWORD=postgres # change this to improve security PENTAGI_POSTGRES_DB=pentagidb ## Postgres (pgvector) connection pool settings DATABASE_MAX_OPEN_CONNS= DATABASE_MAX_IDLE_CONNS= DATABASE_VECTOR_MAX_CONNS= ## Postgres schema handling, only used when TENANT_ID is set (Supabase needs ## DATABASE_EXTENSIONS_SCHEMA=extensions; its pooler may need the other one). ## See backend/docs/config.md -> "Multi-Instance Deployment (TENANT_ID)". DATABASE_EXTENSIONS_SCHEMA= DATABASE_SEARCH_PATH_VIA_OPTIONS= ## Graphiti knowledge graph settings ## Set GRAPHITI_ENABLED=true and GRAPHITI_URL=http://graphiti:8000 to enable embedded Graphiti GRAPHITI_ENABLED=false GRAPHITI_TIMEOUT=30 GRAPHITI_URL= GRAPHITI_CPUS=2.0 GRAPHITI_MEMORY=2G ## Graphiti LLM provider preset: openai, gemini, custom, or litellm. ## Model and request settings are loaded from examples/graphiti/.yaml. ## OpenAI, Gemini, and custom providers reuse the corresponding credentials above. ## Keep this set to llm_configs only when the adjacent graphiti directory is installed. ## Older .env files omit it, so a newer compose file cannot shadow built-in configs ## with an empty host directory. ## Override the host path for development deployments when needed. GRAPHITI_CONFIG_PATH=./graphiti GRAPHITI_CONFIG_DIR=llm_configs GRAPHITI_LLM_CLIENT_TYPE=openai GRAPHITI_LITELLM_BASE_URL= GRAPHITI_LITELLM_API_KEY= ## Use the shared EMBEDDING_URL, EMBEDDING_KEY, and EMBEDDING_MODEL settings above. ## Graphiti requires an OpenAI-compatible embedding endpoint. When disabled, ## Graphiti uses the selected LLM provider credentials instead. GRAPHITI_SEPARATE_EMBEDDING=false ## Graphiti runtime and logging GRAPHITI_SEMAPHORE_LIMIT=20 GRAPHITI_TELEMETRY_ENABLED=false GRAPHITI_LOG_FORMAT=json GRAPHITI_LOG_LEVEL=INFO GRAPHITI_LOG_STDOUT=events GRAPHITI_FLOW_LOGGER_WARN_COUNT=256 GRAPHITI_DEBUG_RUNTIME_RESOURCES=false GRAPHITI_SEARCH_SCOPE=flowid ## Graphiti ingestion policy and worker settings GRAPHITI_INGEST_POLICY_RULES='{"graphiti_search":"REJECT","tool_execution_terminal":"PROCESS","tool_execution_file":"PROCESS"}' GRAPHITI_INGEST_POLICY_FIELD=both GRAPHITI_INGEST_POLICY_DEFAULT_ACTION=SKIP_LLM GRAPHITI_INGEST_USE_GROUP_ACTORS=true GRAPHITI_INGEST_WORKER_COUNT=16 GRAPHITI_INGEST_LOCK_BY_GROUP_ID=true GRAPHITI_INGEST_TASK_MAX_RETRIES=1 GRAPHITI_INGEST_TASK_RETRY_DELAY_SEC=2.0 GRAPHITI_INGEST_TASK_TIMEOUT_SEC=0 GRAPHITI_INGEST_QUEUE_MAX_SIZE=0 GRAPHITI_INGEST_DEAD_LETTER_ENABLED=false ## Graphiti extraction and graph-linking settings GRAPHITI_TAXONOMY_LAYER_PROFILE=STRUCTURAL,EVIDENCE,PROGRESS,ATTEMPT GRAPHITI_USE_COMBINED_FULL_EXTRACTION=true GRAPHITI_USE_COMBINED_EXTRACTION=true GRAPHITI_COMBINED_FULL_GATING_ENABLED=true GRAPHITI_COMBINED_DIAGNOSTIC_SAMPLES=false GRAPHITI_ANCHOR_NODE_MODE=smart GRAPHITI_ANCHOR_NODE_LIMIT=25 GRAPHITI_ANCHOR_MASS_TYPE_LIMIT=10 GRAPHITI_ANCHOR_QUERY_TIMEOUT=10 # Neo4j settings (used by Graphiti stack) NEO4J_USER=neo4j NEO4J_DATABASE=neo4j NEO4J_PASSWORD=devpassword # change this to improve security NEO4J_URI=bolt://neo4j:7687 NEO4J_CPUS=4.0 NEO4J_MEMORY=4G ## /dev/shm is a separate limit but its actual usage counts toward NEO4J_MEMORY. NEO4J_SHM_SIZE=4g NEO4J_NOFILE=65536 ## JVM heap/page cache sizing; NEO4J_CPUS/NEO4J_MEMORY only cap the container. Defaults favor ## heap over page cache for a low write-throughput deployment with occasional wide reads. NEO4J_HEAP_INITIAL_SIZE=2G NEO4J_HEAP_MAX_SIZE=2G NEO4J_PAGECACHE_SIZE=1G ## Caps a single transaction so one runaway query fails cleanly instead of exhausting heap. NEO4J_TRANSACTION_MAX=1G NEO4J_BOLT_ADVERTISED_ADDRESS= ## Set only when a reverse proxy in front of Neo4j Browser strips/rewrites the Host ## header (so the dynamic Host-header-based advertised address is wrong); format host:port. NEO4J_HTTP_ADVERTISED_ADDRESS= ## Host directory with static, non-.env-tunable Neo4j/APOC settings and the ## pinned APOC plugin jar (conf/ and plugins/ subdirectories) NEO4J_DIR=./neo4j ## PentAGI image settings PENTAGI_IMAGE= ## Scraper network settings ## Default ports: SCRAPER_LISTEN_IP=127.0.0.1, SCRAPER_LISTEN_PORT=9443 ## Note: These settings don't need to change for Podman rootless SCRAPER_LISTEN_IP= SCRAPER_LISTEN_PORT= ## Postgres network settings PGVECTOR_LISTEN_IP= PGVECTOR_LISTEN_PORT= ## Postgres Exporter network settings POSTGRES_EXPORTER_LISTEN_IP= POSTGRES_EXPORTER_LISTEN_PORT= # Langfuse Environment Variables ## Langfuse server settings LANGFUSE_LISTEN_IP= LANGFUSE_LISTEN_PORT= LANGFUSE_NEXTAUTH_URL= ## Langfuse Postgres LANGFUSE_POSTGRES_USER=postgres LANGFUSE_POSTGRES_PASSWORD=postgres # change this to improve security LANGFUSE_POSTGRES_DB=langfuse ## Langfuse Clickhouse LANGFUSE_CLICKHOUSE_USER=clickhouse LANGFUSE_CLICKHOUSE_PASSWORD=clickhouse # change this to improve security LANGFUSE_CLICKHOUSE_URL=http://langfuse-clickhouse:8123 LANGFUSE_CLICKHOUSE_MIGRATION_URL=clickhouse://langfuse-clickhouse:9000 LANGFUSE_CLICKHOUSE_CLUSTER_ENABLED=false ## Langfuse S3 LANGFUSE_S3_BUCKET=langfuse LANGFUSE_S3_REGION=auto LANGFUSE_S3_ACCESS_KEY_ID=accesskey # change this to improve security LANGFUSE_S3_SECRET_ACCESS_KEY=secretkey # change this to improve security LANGFUSE_S3_ENDPOINT=http://langfuse-minio:9000 LANGFUSE_S3_FORCE_PATH_STYLE=true LANGFUSE_S3_EVENT_UPLOAD_PREFIX=events/ LANGFUSE_S3_MEDIA_UPLOAD_PREFIX=media/ LANGFUSE_S3_BATCH_EXPORT_ENABLED=true ## Langfuse Redis LANGFUSE_REDIS_HOST=langfuse-redis LANGFUSE_REDIS_PORT=6379 LANGFUSE_REDIS_AUTH=redispassword # change this to improve security LANGFUSE_REDIS_TLS_ENABLED=false LANGFUSE_REDIS_TLS_CA= LANGFUSE_REDIS_TLS_CERT= LANGFUSE_REDIS_TLS_KEY= ## Langfuse web app security settings LANGFUSE_SALT=salt # change this to improve security LANGFUSE_ENCRYPTION_KEY=0000000000000000000000000000000000000000000000000000000000000000 # change this to improve security ## Langfuse web app nextauth settings LANGFUSE_NEXTAUTH_URL=http://localhost:4000 LANGFUSE_NEXTAUTH_SECRET=secret # change this to improve security ## Langfuse extra settings LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES=true LANGFUSE_TELEMETRY_ENABLED=false LANGFUSE_LOG_LEVEL=info ## Langfuse init settings LANGFUSE_INIT_ORG_ID=ocm47619l0000872mcd2dlbqwb LANGFUSE_INIT_ORG_NAME=PentAGI Org LANGFUSE_INIT_PROJECT_ID=cm47619l0000872mcd2dlbqwb LANGFUSE_INIT_PROJECT_NAME=PentAGI LANGFUSE_INIT_PROJECT_PUBLIC_KEY=pk-lf-00000000-0000-0000-0000-000000000000 # change this to improve security LANGFUSE_INIT_PROJECT_SECRET_KEY=sk-lf-00000000-0000-0000-0000-000000000000 # change this to improve security LANGFUSE_INIT_USER_EMAIL=admin@pentagi.com LANGFUSE_INIT_USER_NAME=admin LANGFUSE_INIT_USER_PASSWORD=password # change this to improve security ## Langfuse SDK sync settings LANGFUSE_SDK_CI_SYNC_PROCESSING_ENABLED=false LANGFUSE_READ_FROM_POSTGRES_ONLY=false LANGFUSE_READ_FROM_CLICKHOUSE_ONLY=true LANGFUSE_RETURN_FROM_CLICKHOUSE=true ## Langfuse ingestion tuning LANGFUSE_INGESTION_QUEUE_DELAY_MS= LANGFUSE_INGESTION_CLICKHOUSE_WRITE_INTERVAL_MS= LANGFUSE_INGESTION_CLICKHOUSE_WRITE_BATCH_SIZE= LANGFUSE_INGESTION_CLICKHOUSE_MAX_ATTEMPTS= ## Langfuse email LANGFUSE_EMAIL_FROM_ADDRESS= LANGFUSE_SMTP_CONNECTION_URL= ## Langfuse optional Azure blob LANGFUSE_USE_AZURE_BLOB=false ## Langfuse license settings LANGFUSE_EE_LICENSE_KEY= ## Langfuse OpenTelemetry settings LANGFUSE_OTEL_EXPORTER_OTLP_ENDPOINT= LANGFUSE_OTEL_SERVICE_NAME= ## Langfuse custom oauth2 settings LANGFUSE_AUTH_CUSTOM_CLIENT_ID= LANGFUSE_AUTH_CUSTOM_CLIENT_SECRET= LANGFUSE_AUTH_CUSTOM_ISSUER= LANGFUSE_AUTH_CUSTOM_NAME=PentAGI LANGFUSE_AUTH_CUSTOM_SCOPE=openid email profile LANGFUSE_AUTH_CUSTOM_CLIENT_AUTH_METHOD=client_secret_post LANGFUSE_AUTH_CUSTOM_ALLOW_ACCOUNT_LINKING=true ## Langfuse auth settings LANGFUSE_AUTH_DISABLE_SIGNUP=false # disable signup if PentAGI OAuth2 is used LANGFUSE_AUTH_SESSION_MAX_AGE=240 ## Langfuse allowed organization creators LANGFUSE_ALLOWED_ORGANIZATION_CREATORS=admin@pentagi.com ## Langfuse default settings for new users LANGFUSE_DEFAULT_ORG_ID=ocm47619l0000872mcd2dlbqwb LANGFUSE_DEFAULT_PROJECT_ID=cm47619l0000872mcd2dlbqwb LANGFUSE_DEFAULT_ORG_ROLE=VIEWER LANGFUSE_DEFAULT_PROJECT_ROLE=VIEWER # Observability Environment Variables ## Observability server settings GRAFANA_LISTEN_IP= GRAFANA_LISTEN_PORT= ## OpenTelemetry server settings OTEL_GRPC_LISTEN_IP= OTEL_GRPC_LISTEN_PORT= OTEL_HTTP_LISTEN_IP= OTEL_HTTP_LISTEN_PORT=