Docs
MatrixEasyMode documentation for deploying and operating self-hosted Matrix + Element communication.
MatrixEasyMode documentation for deploying and running Matrix + Element on your own infrastructure, with Docker Compose, PostgreSQL, and Nginx Proxy Manager.
Start with the quick path if you want a working deployment. Use the deeper docs when you need installation details, configuration, troubleshooting, network behavior, or operational guidance.
With thanks to upstream projects
MatrixEasyMode stands on the work of the communities behind Matrix / Synapse, Element, Nginx Proxy Manager, PostgreSQL, Linux, and Docker. Their work makes this project possible.
Get Started
The fastest path to a working MatrixEasyMode deployment. Start here to prepare your host, run the installer, finish NPM setup, and bring the app online in the right order.
Installation
Quick-start, full installation, and advanced deployment guidance.
Installation Guide
Advanced Install
Operations
Configuration, runtime behavior, troubleshooting, upgrades, and day-to-day operation.
Configuration
Operations Guide
Troubleshooting
Architecture
How MatrixEasyMode is structured, what it runs, and how the deployment model fits together.
Architecture
Releases
Release notes, version history, and what changed between versions.
Release Notes
MatrixEasyMode v0.1.0
Tools
Optional tools such as pgAdmin and Portainer for inspecting and managing the environment.
Tools
Optional pgAdmin
Optional Portainer