mosaicstack/stack
19
0
Fork 1
Code Issues 335 Pull Requests 15 Actions Packages Projects Releases 15 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
Copy Source

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)
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 <[email protected]>
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
Clear labels
bug
Defect in framework tooling or delivered code
 fleet-enhancement
Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
code-be-01 (Mosaic fleet seat code-be-01) code-be-02 (Mosaic fleet seat code-be-02) code-infra-01 (Mosaic fleet seat code-infra-01) fargo fred gate-merge-01 (Mosaic fleet seat gate-merge-01) happy jason.woltje (Jason Woltje) marcie merge-gate ops-01 (Mosaic fleet seat ops-01) ops-02 (Mosaic fleet seat ops-02) ops-03 (Mosaic fleet seat ops-03) ops-ci-01 (Mosaic fleet seat ops-ci-01) ops-deploy-01 (Mosaic fleet seat ops-deploy-01) orch-01 (Mosaic fleet seat orch-01) pepper resume rev-code-01 rev-code-02 rev-security-01 rev-security-02 rev-security-03 (Mosaic fleet seat rev-security-03) sanity scooby (Scooby) scrappy shaggy tiny velma veronica (Mosaic fleet seat veronica) vision woodpecker
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#153