# ────────────────────────────────────────────────────────────────────────────── # Aether Substrate — Environment Configuration # Copy this file to .env and fill in the values: cp .env.example .env # Or run `aether-substrate init` for an interactive walkthrough. # ────────────────────────────────────────────────────────────────────────────── # ── Required ───────────────────────────────────────────────────────────────── # Shared secret between the frontend and Substrate API. # Generate one with: openssl rand -hex 32 SUBSTRATE_API_KEY= # Docker socket group ID — needed for container management. # macOS: 20 (staff group) | Linux: run `getent group docker | cut -d: -f3` # Rootless Podman: use your user GID (`id -g`) DOCKER_GID=20 # Container runtime CLI used by the `aether-substrate` command. # Supported: docker (default, also covers OrbStack / Rancher / Colima / Docker Desktop), # podman, nerdctl, or any other docker-compatible binary on your PATH. # CONTAINER_RUNTIME=docker # ── Feature Flags ──────────────────────────────────────────────────────────── # Enable Docker container management (run user containers) SUBSTRATE_ENABLE_CONTAINERS=true # Enable the persistent workspace container SUBSTRATE_ENABLE_WORKSPACE=true # Enable substrate host terminal WebSocket (xterm.js ↔ node-pty) SUBSTRATE_ENABLE_TERMINAL_WS=false # Enable vector embeddings (EmbeddingGemma semantic search) # Downloads ~150MB ONNX model on first run. Requires rebuild after enabling. SUBSTRATE_ENABLE_EMBEDDINGS=false # ── Embeddings Config (only relevant when SUBSTRATE_ENABLE_EMBEDDINGS=true) ── # ONNX model ID from Hugging Face (default: embeddinggemma-300m) # EMBEDDINGS_MODEL_ID=onnx-community/embeddinggemma-300m-ONNX # Quantization level: fp32 (highest quality), fp16, q4 (smallest), q4f16 # EMBEDDINGS_DTYPE=q4 # Vector dimensions: 768 (full), 512, 256, or 128 (Matryoshka truncation) # EMBEDDINGS_DIMENSIONS=768 # Go embedding server port (internal, not exposed outside the container) # EMBEDDING_SERVER_PORT=3101 # ── Container Limits (only relevant when SUBSTRATE_ENABLE_CONTAINERS=true) ── # Maximum number of user containers # SUBSTRATE_MAX_CONTAINERS=5 # CPU limit per container (fractional cores) # SUBSTRATE_CONTAINER_MAX_CPU=1.0 # Memory limit per container (MB) # SUBSTRATE_CONTAINER_MAX_MEMORY_MB=512 # Comma-separated list of allowed Docker images # SUBSTRATE_CONTAINER_IMAGE_ALLOWLIST=node:20-alpine,node:22-alpine,python:3.12-slim,python:3.13-slim,ubuntu:24.04,alpine:3.19,debian:bookworm-slim,golang:1.22-alpine,oven/bun:latest,denoland/deno:latest # Workspace container image # SUBSTRATE_WORKSPACE_IMAGE=node:22-alpine # ── LLM Gateway ───────────────────────────────────────────────────────────── # Enable the LLM gateway (enabled by default — set to false to disable) # SUBSTRATE_ENABLE_LLM=true # Default LLM provider: ollama | lmstudio | openai-compatible | anthropic | openai | letta # LLM_DEFAULT_PROVIDER=ollama # Default model name (provider-specific) # LLM_DEFAULT_MODEL= # Custom base URL (overrides the provider's default) # LLM_DEFAULT_BASE_URL=http://localhost:11434/v1 # API key for hosted providers (Anthropic, OpenAI, etc.) # LLM_API_KEY= # ── Networking ─────────────────────────────────────────────────────────────── # Extra CORS origins (comma-separated). The frontend origin is always allowed. # SUBSTRATE_ALLOWED_ORIGINS=https://example.com,https://other.example.com # HTTPS port for Caddy reverse proxy # SUBSTRATE_HTTPS_PORT=8443 # Trust X-Forwarded-For / X-Real-IP headers for per-IP rate limiting. # Default: true (safe inside the docker-compose stack, which sits behind Caddy). # Set to false when the API is reachable directly (LAN, Tailscale, --network=host) # — otherwise clients can spoof their source IP and bypass the rate limiter. # SUBSTRATE_TRUST_PROXY=true # ── Security Hardening ────────────────────────────────────────────────────── # Language-server versions used by the LSP bridge (pinned to close the # "ambient install at first use" supply-chain window). Bump deliberately. # LSP_TYPESCRIPT_VERSION=4.3.4 # LSP_TYPESCRIPT_LANG_VERSION=5.6.3 # LSP_PYRIGHT_VERSION=1.1.389 # LSP_GOPLS_VERSION=v0.16.2 # ── Cloudflare Tunnel (optional) ──────────────────────────────────────────── # Path to the directory containing your tunnel credentials JSON file. # Only needed if using docker-compose.cloudflared.yml overlay. # CLOUDFLARED_CREDENTIALS_FILE=~/.cloudflared # Optional explicit Cloudflare tunnel name. # If omitted, the CLI generates a unique name per instance and saves it to .env. # CLOUDFLARED_TUNNEL_NAME=aether-substrate-your-machine-abc123 # ── Tailscale Sidecar (optional) ──────────────────────────────────────────── # Pre-auth key for Tailscale sidecar container. # Generate at: https://login.tailscale.com/admin/settings/keys # TS_AUTHKEY=tskey-auth-...