mosaic/stack
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Sample Matrix swarm deployment compose file #387

New Issue
Closed
opened 2026-02-15 07:12:34 +00:00 by jason.woltje · 0 comments
jason.woltje commented 2026-02-15 07:12:34 +00:00
Owner
Copy Link

Summary

Provide a sample docker-compose.sample.matrix.yml in the docker/ folder for deploying Synapse + Element as standalone swarm infrastructure.

Context

Matrix (Synapse + Element) is separate infrastructure from Mosaic Stack — same pattern as Authentik. Users deploy it independently and point Mosaic at it via env vars.

This sample file helps users deploy their Matrix homeserver on Docker Swarm (e.g., via Portainer), with Traefik integration matching the existing Stack conventions.

What's Included

  • Synapse — Matrix homeserver with Traefik labels, health checks, PostgreSQL dependency
  • Element Web — Matrix client with Traefik labels
  • PostgreSQL — Dedicated Synapse database (separate from Mosaic's PostgreSQL)
  • coturn — Optional TURN/STUN server for VoIP (commented out)

File Location

docker/docker-compose.sample.matrix.yml

Documentation

The file header includes:

  • Portainer deployment instructions
  • CLI swarm deployment instructions
  • Post-deploy setup (Synapse config generation, bot account creation, access token)
  • Environment variable reference
  • Instructions for connecting to Mosaic Stack

Status

DONE — File created at docker/docker-compose.sample.matrix.yml

Refs

## Summary Provide a sample `docker-compose.sample.matrix.yml` in the `docker/` folder for deploying Synapse + Element as standalone swarm infrastructure. ## Context Matrix (Synapse + Element) is **separate infrastructure** from Mosaic Stack — same pattern as Authentik. Users deploy it independently and point Mosaic at it via env vars. This sample file helps users deploy their Matrix homeserver on Docker Swarm (e.g., via Portainer), with Traefik integration matching the existing Stack conventions. ## What's Included - **Synapse** — Matrix homeserver with Traefik labels, health checks, PostgreSQL dependency - **Element Web** — Matrix client with Traefik labels - **PostgreSQL** — Dedicated Synapse database (separate from Mosaic's PostgreSQL) - **coturn** — Optional TURN/STUN server for VoIP (commented out) ## File Location `docker/docker-compose.sample.matrix.yml` ## Documentation The file header includes: - Portainer deployment instructions - CLI swarm deployment instructions - Post-deploy setup (Synapse config generation, bot account creation, access token) - Environment variable reference - Instructions for connecting to Mosaic Stack ## Status **DONE** — File created at `docker/docker-compose.sample.matrix.yml` ## Refs - Pattern: `docker/docker-compose.example.external.yml`, `docker/docker-compose.example.turnkey.yml` - EPIC: #377 - Related: #384 (dev compose)
jason.woltje added the devops label 2026-02-15 07:12:34 +00:00
jason.woltje added this to the M12-MatrixBridge (0.0.12) milestone 2026-02-15 07:33:09 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai
AI/LLM integration
 api
Backend/API work
 api
auth
Authentication
 database
database
Database/schema work
 devops
Docker/deployment
 docs
Documentation
 frontend
graph
knowledge-module
migration
Data migration
 orchestrator
Orchestrator service (apps/orchestrator/)
 p0
Critical priority
 p1
High priority
 p2
Medium priority
 p3
Low priority
 performance
Performance work
 phase-1
phase-2
phase-3
phase-4
phase-5
plugin
MoltBot plugin work
 search
security
Security-related
 setup
Initial setup
 testing
Testing/QA
 web
Frontend work
No Label devops
Milestone
No items
No Milestone M12-MatrixBridge (0.0.12)
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: mosaic/stack#387
Delete Branch "%!s()"

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?