This is not intended for serious production usage, but instead as a tool for curious sysadmins to easily experiment with Matrix 2.0 in a simple docker compose environment. As of Nov 2024, it's considered beta.

In particular, this has:

No support or maintenance guarantees whatsoever
No high availability, horizontal scalability, elastic scaling, clustering, backup etc.
No admin interface
No UDP traffic or TURN for LiveKit (all traffic is tunnelled over TCP for simplicity)
No integration manager, integrations, or identity lookup server

For production-grade Matrix from Element, please see https://element.io/server-suite (ESS).

To run

Install Docker Compose. Then:

./setup.sh
docker compose up

To configure

Check the .env file, or customise the templates in /data-templates and then docker compose down && docker compose up -d.

In particular, you may wish to:

Point at your own SMTP server rather than mailhog
Use your own reverse proxy rather than the provided nginx
Use your own database cluster

To admin

# To register a user
docker compose exec mas mas-cli -c /data/config.yaml manage register-user

Diagnostics

# check that OIDC is working - useful for debugging TLS problems
docker compose exec mas mas-cli -c /data/config.yaml doctor