trixcord-matrix

Configuration for the Matrix homeserver container — Dendrite with a local nginx reverse proxy.

This repository is self-contained: clone it directly on the homeserver container and follow the steps below.

Part of the Trixcord infrastructure. See the hub repository for the full architecture overview.

Repository layout

.
├── .env.example                  # Environment variable template
├── config/
│   ├── dendrite.yaml.example     # Dendrite configuration template
│   └── nginx/
│       └── matrix-local.conf     # Local nginx reverse proxy (internal → Dendrite)
├── docs/
│   └── dendrite.md               # Build, deploy & update guide
└── systemd/
    └── dendrite.service          # systemd unit file

Quick start

1. Clone this repository

git clone https://git.sidera.fr/DrTrix/trixcord-matrix.git
cd trixcord-matrix

2. Configure environment

cp .env.example .env
$EDITOR .env   # fill in all variables

3. Build and deploy Dendrite

Follow docs/dendrite.md to compile Dendrite from source, install the systemd service, and deploy the configuration:

cp config/dendrite.yaml.example /opt/dendrite/config/dendrite.yaml
$EDITOR /opt/dendrite/config/dendrite.yaml   # substitute ${VAR} placeholders

4. Deploy the local nginx proxy

apt install -y nginx
cp config/nginx/matrix-local.conf /etc/nginx/sites-available/matrix-local
ln -s /etc/nginx/sites-available/matrix-local /etc/nginx/sites-enabled/matrix-local
rm /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx

5. Start Dendrite

cp systemd/dendrite.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now dendrite
journalctl -u dendrite -f

Updating Dendrite

See the Update procedure section in docs/dendrite.md.