Files
stackpilot/.env.example
T
menzeljandClaude Opus 5 6af02a1367 Default STACKS_HOST_DIR to /opt/stacks so host and container paths match
The shipped default (./data/stacks) guarantees the mismatch that hid stack data
from the file browser, the editor and (before 0.40.0) from backups: compose
resolves ./config against the container path, so the daemon creates the data
directories at /opt/stacks/<stack>/... on the host regardless of where
STACKS_HOST_DIR points. Same change for the agent, plus the reasoning in
.env.example and the README config table. Images unchanged (0.40.1).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-16 18:35:22 +00:00

34 lines
1.7 KiB
Bash

# Required: a long random secret for signing JWTs.
# Generate with: openssl rand -base64 48
SECRET_KEY=change-me-to-a-long-random-string
# Host directory where stack folders (compose.yaml + .env) are stored.
# It MUST be the same path as STACKS_DIR inside the container (/opt/stacks):
# compose runs in the backend container and resolves a stack's relative bind
# mounts (./config) against the *container* path, so the daemon creates those
# data directories at that path on the host. With a different host path here,
# every stack's data lands outside StackPilot's view — the file browser and the
# editor won't see it (backups capture it either way, via a helper container).
STACKS_HOST_DIR=/opt/stacks
# Allowed CORS origin(s) for the API (comma separated). The bundled frontend
# proxies /api, so this only matters if you call the API from another origin.
CORS_ORIGINS=http://localhost:5009
# Optional: comma-separated generic JSON webhook URLs that receive every event.
# Richer per-destination webhooks (ntfy/Discord/Slack/Gotify, per-event) are
# managed from Settings → Notifications in the UI.
NOTIFY_WEBHOOKS=
# Throwaway image used to read/write named-volume contents during backups.
BACKUP_HELPER_IMAGE=alpine:latest
# File browser (sidebar) + volume host-path picker.
# ALLOWED_BROWSE_ROOTS: comma-separated paths the browser may reach (sandbox).
# HOST_ROOT_PREFIX: where the host filesystem is mounted inside the backend
# container. Leave empty to browse the container's own filesystem. To browse
# the real host, uncomment the "/:/host_root" volume in docker-compose.yml and
# set HOST_ROOT_PREFIX=/host_root here (mount without :ro to allow edits).
ALLOWED_BROWSE_ROOTS=/,/mnt,/media,/srv,/opt
HOST_ROOT_PREFIX=