# spantaleev/matrix-docker-ansible-deploy **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/spantaleev-matrix-docker-ansible-deploy).** 6,050 stars · 1,142 forks · Jinja · agpl-3.0 ## Links - GitHub: https://github.com/spantaleev/matrix-docker-ansible-deploy - awesome-repositories: https://awesome-repositories.com/repository/spantaleev-matrix-docker-ansible-deploy.md ## Topics `ansible-playbook` `ansible-role` `automation` `docker` `jitsi` `matrix-org` `matrix-server` `self-hosting` ## Description This project is an Ansible-based deployment tool that automates the setup of a fully configured Matrix homeserver using Docker containers. It orchestrates the entire Matrix server stack, including the homeserver itself, a PostgreSQL database, and reverse proxy integration with Traefik for automatic SSL certificate management, all from a single configuration file. The deployment supports connecting a Matrix installation to external messaging platforms like Discord, Slack, Telegram, and WhatsApp through dedicated bridges that run as isolated Docker containers. It also provides the ability to deploy Matrix-compatible web chat clients such as Element, Cinny, or Hydrogen on custom domains for end-user access, and includes a graphical web interface for managing users, rooms, media, and sessions on the homeserver. Additional capabilities include integrating chat bots for reminders, moderation, AI chat, or helpdesk features, redirecting media storage to external S3-compatible object stores, configuring user authentication methods and registration flows, and integrating monitoring services to track server health and performance. The documentation covers installation, configuration, and maintenance of the entire deployment. ## Tags ### DevOps & Infrastructure - [Deployment Tools](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-platform-as-a-service/homeservers/deployment-tools.md) — Provides Ansible-based automation for deploying fully configured Matrix homeservers with Docker. - [Docker Compose Deployments](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-compose-deployments.md) — Links each Matrix component in its own Docker container through Docker Compose for modular service management. - [Matrix Homeserver Provisioners](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-deployments/ansible-provisioners/matrix-homeserver-provisioners.md) — Uses Ansible playbooks to orchestrate the entire Matrix homeserver setup across multiple Docker containers from a single configuration file. - [Matrix Homeserver Dashboards](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-platform-as-a-service/homeservers/matrix-homeserver-dashboards.md) — Ships a graphical web interface for managing users, rooms, media, and sessions on the Matrix homeserver. - [S3-Compatible Storage Adapters](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/cloud-storage/s3-compatible-storage-adapters.md) — Redirects the Matrix media repository to external S3-compatible object stores by replacing the local filesystem mount with a remote storage backend. - [Media Storage Redirects](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/cloud-storage/s3-compatible-storage-adapters/media-storage-redirects.md) — Supports redirecting Matrix media uploads to external S3-compatible object stores. - [Role-Based Configuration Modularization](https://awesome-repositories.com/f/devops-infrastructure/role-based-configuration-modularization.md) — Defines reusable Ansible role configuration blocks that inherit and override settings for customisation without modifying core playbooks. ### Networking & Communication - [Matrix Servers](https://awesome-repositories.com/f/networking-communication/matrix-servers.md) — Automates the setup of a Matrix homeserver with Ansible and Docker to join the federated network under your own domain. ([source](https://cdn.jsdelivr.net/gh/spantaleev/matrix-docker-ansible-deploy@master/README.md)) - [Matrix Network Bridges](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/communication-platforms/messaging-middleware/chat-platform-integrations/matrix-network-bridges.md) — Connects a Matrix server to external platforms like Discord, Slack, Telegram, and WhatsApp for cross-platform messaging. - [Hosting Deployments](https://awesome-repositories.com/f/networking-communication/matrix-web-clients/hosting-deployments.md) — Deploys Matrix-compatible web clients such as Element, Cinny, or Hydrogen on custom domains. - [Chat Bot Integrations](https://awesome-repositories.com/f/networking-communication/chat-bot-integrations.md) — Installs bots that deliver reminders, moderation, AI chat, registration tokens, or helpdesk features inside Matrix rooms. ([source](https://cdn.jsdelivr.net/gh/spantaleev/matrix-docker-ansible-deploy@master/README.md)) - [Nginx-Served Clients](https://awesome-repositories.com/f/networking-communication/matrix-web-clients/nginx-served-clients.md) — Serves web-based Matrix clients through Nginx containers configured to proxy requests to the appropriate client application. - [Self-Hosted Deployments](https://awesome-repositories.com/f/networking-communication/matrix-web-clients/self-hosted-deployments.md) — Serves Matrix-compatible web client applications on custom domains for end-user access. ([source](https://github.com/spantaleev/matrix-docker-ansible-deploy/tree/master/docs/)) ### Artificial Intelligence & ML - [Matrix Chat Network Bridges](https://awesome-repositories.com/f/artificial-intelligence-ml/messaging-platform-bridges/matrix-chat-network-bridges.md) — Bridges Matrix to Discord, Slack, Telegram, and WhatsApp through dedicated Docker containers. ([source](https://cdn.jsdelivr.net/gh/spantaleev/matrix-docker-ansible-deploy@master/README.md)) - [Matrix Network Bridges](https://awesome-repositories.com/f/artificial-intelligence-ml/messaging-platform-bridges/matrix-network-bridges.md) — Enables connectivity to external messaging networks like Discord, Slack, Telegram, and WhatsApp through dedicated bridges. ### Data & Databases - [Containerized PostgreSQL Backends](https://awesome-repositories.com/f/data-databases/postgresql-database-platforms/containerized-postgresql-backends.md) — Stores all persistent Matrix data in a dedicated PostgreSQL container with optional replication and backup configurations. - [S3-Compatible Cloud Storage](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-persistence-storage/data-storage/file-based-storage/local-file-storage/s3-compatible-cloud-storage.md) — Redirects the Matrix media repository to Amazon S3 or other S3-compatible object stores instead of the local filesystem. ([source](https://cdn.jsdelivr.net/gh/spantaleev/matrix-docker-ansible-deploy@master/README.md)) - [File Storage Management](https://awesome-repositories.com/f/data-databases/file-storage-management.md) — Replaces the default media storage folder with alternative backends for storing uploaded files and media. ([source](https://github.com/spantaleev/matrix-docker-ansible-deploy/tree/master/docs/)) ### Web Development - [Traefik Integrations](https://awesome-repositories.com/f/web-development/reverse-proxy-integrations/traefik-integrations.md) — Routes external HTTPS traffic to internal Docker services using Traefik, which automatically manages SSL certificates via Let's Encrypt. ### Security & Cryptography - [User Authentication Flows](https://awesome-repositories.com/f/security-cryptography/user-authentication-flows.md) — Configures user authentication methods and registration flows on the Matrix homeserver. ([source](https://github.com/spantaleev/matrix-docker-ansible-deploy/tree/master/docs/)) ### Software Engineering & Architecture - [Chat Network Bridge Containers](https://awesome-repositories.com/f/software-engineering-architecture/bridge-architectures/chat-network-bridge-containers.md) — Runs third-party chat bridges as isolated Docker containers, each with its own configuration and network interface to the Matrix homeserver.