Skip to content

Matrix/Synapse — Setup

Self-hosted Matrix homeserver. Runs as a Docker container on LXC 121 (matrix). Data stored in /opt/matrix/data/.

  • GitHub: https://github.com/element-hq/synapse
  • Website: https://matrix.org

Infrastructure

Host Internal URL
Docker (LXC 121) 192.168.1.121:8008 https://matrix.eva-00.network

Observability

Logs

Matrix/Synapse logs are collected via Grafana Alloy Docker discovery and shipped to Loki.

Query Purpose
{container="synapse"} All container output
{container="synapse"} \|= "error" Errors only
{container="synapse"} \|= "federation" Federation issues

Access: Grafana → Explore → Loki → Enter query

Metrics

Synapse does not export Prometheus metrics by default. Use Loki logs to diagnose issues.

IaC

Artifact Path
Playbook ansible/playbooks/matrix.yml
Workflow .forgejo/workflows/matrix.yml
Compose services/matrix/docker-compose.yml
Config services/matrix/homeserver.yaml

Existing users

Username Role
holo admin