Volver a las aplicaciones Presentar una aplicaciónEnviar

Matrix

Aplicación Docker from junkerderprovinz Repository

Visión general

All-in-one Matrix homeserver for Unraid: Synapse + coturn + Element Web (/element/) + Synapse-Admin (/admin/). Plug-and-play — just fill in SERVER_NAME and Postgres connection, everything else is generated automatically. PREREQUISITES (before starting the container): 1) PostgreSQL database — connect to your Postgres container and run: CREATE USER matrix WITH PASSWORD 'yourpass'; CREATE DATABASE matrix ENCODING 'UTF8' LC_COLLATE='C' LC_CTYPE='C' TEMPLATE template0 OWNER matrix; (UTF8 + LC_COLLATE='C' is mandatory — Synapse will refuse to start otherwise.) 2) Reverse proxy (Nginx Proxy Manager) for matrix.yourdomain.tld → Unraid-IP:8008. In the proxy host → Advanced tab, add: client_max_body_size 100m; proxy_read_timeout 600s; (Without these, media uploads fail and long-running requests time out.) 3) For federation: two extra Custom Locations on the SAME proxy host for /.well-known/matrix/server and /.well-known/matrix/client → Unraid-IP:8080. Full step-by-step guide (NPM screenshots, well-known, first user): https://github.com/junkerderprovinz/matrix#readme

Requisitos

PostgreSQL container with a database: ENCODING UTF8, LC_COLLATE=C, LC_CTYPE=C

Argumentos en tiempo de ejecución

Interfaz web: http://[IP]:[PORT:8080]/element/
Red: bridge
Concha: sh
Privilegiado: false

Configuración de plantillas

Matrix HTTP APIPorttcp

Synapse HTTP API. Expose via reverse proxy with HTTPS — never directly to the internet.

Objetivo: 8008
Por defecto: 8008
Valor: 8008

Element Web + Synapse-AdminPorttcp

Serves Element Web (/element/), Synapse-Admin (/admin/) and /.well-known/matrix/* endpoints.

Objetivo: 8080
Por defecto: 8080
Valor: 8080

TURN TCPPorttcp

TURN/STUN over TCP for voice/video calls. Open this port in your router/firewall.

Objetivo: 3478
Por defecto: 3478
Valor: 3478

TURN UDPPortudp

TURN/STUN over UDP for voice/video calls. Open this port in your router/firewall.

Objetivo: 3478
Por defecto: 3478
Valor: 3478

TURN TLS TCPPorttcp

TURN over TLS (TCP). Optional — only if TLS certs are mounted.

Objetivo: 5349
Por defecto: 5349
Valor: 5349

TURN TLS UDPPortudp

TURN over TLS (UDP). Optional — only if TLS certs are mounted.

Objetivo: 5349
Por defecto: 5349
Valor: 5349

Prometheus MetricsPorttcp

Prometheus metrics at /_synapse/metrics. Bind to a private network only.

Objetivo: 9090
Por defecto: 9090
Valor: 9090

Data DirectoryPath

Persistent data: homeserver.yaml, media, signing keys. Never delete — destroys keys and breaks federation.

Objetivo: /data
Por defecto: /mnt/user/appdata/matrix/
Valor: /mnt/user/appdata/matrix/

TURN-TLS CertsPathro

Optional. Mount a folder containing fullchain.pem + privkey.pem to enable TURN-TLS on 5349.

Objetivo: /data/certs

Matrix Server DomainVariable

Your Matrix domain, e.g. matrix.yourdomain.tld. Used in Matrix IDs (@user:matrix.yourdomain.tld). Cannot be changed later without wiping the DB.

Objetivo: SERVER_NAME
Valor: matrix.yourdomain.tld

Anonymous Usage ReportingVariable

Send anonymous usage stats to Matrix.org. 'yes' or 'no'. Recommended: no.

Objetivo: REPORT_STATS
Por defecto: no
Valor: no

Enable FederationVariable

true = chat with the public Matrix network (requires /.well-known/matrix/* on your proxy, see README). false = private island.

Objetivo: ENABLE_FEDERATION
Por defecto: true
Valor: true

PostgreSQL HostVariable

IP of your PostgreSQL server (e.g. Unraid host IP). IP+port is more reliable than container names.

Objetivo: POSTGRES_HOST
Por defecto: 192.168.x.x
Valor: 192.168.x.x

PostgreSQL PortVariable

PostgreSQL port. Default 5432.

Objetivo: POSTGRES_PORT
Por defecto: 5432
Valor: 5432

PostgreSQL UsernameVariable

Postgres user for Synapse. Must already exist (see README — Postgres setup).

Objetivo: POSTGRES_USER
Por defecto: admin
Valor: admin

PostgreSQL PasswordVariable

Password for the Postgres user above.

Objetivo: POSTGRES_PASSWORD

PostgreSQL DatabaseVariable

Synapse database name. Must be created with ENCODING UTF8, LC_COLLATE='C', LC_CTYPE='C' — see Overview.

Objetivo: POSTGRES_DB
Por defecto: matrix
Valor: matrix

Matrix Admin Username (Element / Synapse-Admin login)Variable

Optional. Localpart of the admin user to auto-create on first boot (e.g. 'admin' → @admin:SERVER_NAME). Logs into Element Web + Synapse-Admin. Clear after creation.

Objetivo: ADMIN_USER

Matrix Admin Password (Element / Synapse-Admin login)Variable

Optional. Password for the admin user above. Clear after first boot.

Objetivo: ADMIN_PASSWORD

TimezoneVariable

Container timezone (affects log timestamps).

Objetivo: TZ
Por defecto: Europe/Vienna
Valor: Europe/Vienna

User ID (PUID)Variable

UID Synapse runs as. Default 99 (nobody on Unraid).

Objetivo: PUID
Por defecto: 99
Valor: 99

Group ID (PGID)Variable

GID Synapse runs as. Default 100 (users on Unraid).

Objetivo: PGID
Por defecto: 100
Valor: 100

Categorías

Network > Messenger Network > Other Productivity

Enlaces

Plantilla Ayuda GHCR Project

Detalles

Repositorio

ghcr.io/junkerderprovinz/matrix:latest

Registro

https://ghcr.io/junkerderprovinz/matrix

Última actualización2026-05-31

Visto por primera vez2026-05-13

Ejecute Matrix en Unraid.

Matrix se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.

Explore Unraid OS