mosaicstack/stack
1
0
Fork 0
Code Issues 13 Pull Requests Actions Packages Projects Releases 11 Wiki Activity

docs(deploy): add deployment guide and expand .env.example #153

Merged
jason.woltje merged 1 commits from feat/p7-007-deploy-docs into main 2026-03-15 19:46:39 +00:00
Conversation 0 Commits 1 Files Changed 2 +494 -16
jason.woltje commented 2026-03-15 19:36:01 +00:00
Owner
Copy Link

Summary

  • Adds with Docker Compose quick-start and bare-metal step-by-step deployment guide (prerequisites, DB init, build, nginx/Caddy reverse proxy, systemd service units, security checklist, troubleshooting)
  • Expands with all environment variables found in the codebase, including newly added agent, embedding, summarization, MCP, coordinator, and provider vars

Changes

  • — new deployment guide
  • — comprehensive env var reference with defaults and descriptions

Closes #58

## Summary - Adds with Docker Compose quick-start and bare-metal step-by-step deployment guide (prerequisites, DB init, build, nginx/Caddy reverse proxy, systemd service units, security checklist, troubleshooting) - Expands with all environment variables found in the codebase, including newly added agent, embedding, summarization, MCP, coordinator, and provider vars ## Changes - — new deployment guide - — comprehensive env var reference with defaults and descriptions Closes #58
jason.woltje added 1 commit 2026-03-15 19:36:01 +00:00
docs(deploy): add deployment guide and expand .env.example (#58)
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
Details
b5f1d0b110 
Adds docs/guides/deployment.md covering Docker Compose quick-start and
bare-metal step-by-step deployment: prerequisites, DB init, build, systemd
service units, nginx/Caddy reverse proxy config, security checklist, and
troubleshooting section.

Expands .env.example with all environment variables found in the codebase,
including NEXT_PUBLIC_GATEWAY_URL, agent sandbox/tool/system-prompt settings,
embedding and summarization API config, MCP_SERVERS, MOSAIC_WORKSPACE_ROOT,
OLLAMA_MODELS, and MOSAIC_CUSTOM_PROVIDERS, with defaults and descriptions.

Closes #58

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
jason.woltje merged commit 237a863dfd into main 2026-03-15 19:46:39 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#153
Delete Branch "feat/p7-007-deploy-docs"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?