Something went wrong. Try again.
Something went wrong. Try again.
aether-substrate .env.example
6.0 kB · 123 lines
at main
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124# ──────────────────────────────────────────────────────────────────────────────# 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 32SUBSTRATE_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 containerSUBSTRATE_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-...