Ejecuta un servidor doméstico Matrix ligero en Raspberry Pi 4

Sí, una Raspberry Pi 4 puede ejecutar Conduit, y el proyecto publica versiones para ARM64. Para un servidor doméstico pequeño, personal o familiar, las opciones de configuración más importantes son un sistema operativo de 64 bits, un nombre de servidor Matrix permanente, almacenamiento persistente y enrutamiento HTTPS funcional. Actualmente, Conduit se encuentra en fase beta, así que manténgalo actualizado y no asuma que una Pi 4 tiene una capacidad de usuarios específica; el proyecto no publica datos de rendimiento para la Raspberry Pi 4.

¿Es Conduit la solución adecuada para esta Raspberry Pi?

Conduit es un servidor doméstico ligero de Matrix con RocksDB como base de datos recomendada. Su documentación oficial de implementación incluye una aarch64imagen binaria y una imagen OCI, compatibles con una instalación de Raspberry Pi OS de 64 bits. El registro de cambios del proyecto, consultado el 10 de octubre de 2026, mostraba la versión v0.10.15, con fecha del 30 de septiembre de 2026. La versión anterior, la v0.10.14, solucionó una vulnerabilidad de acceso a la cuenta y recomendó actualizar cuanto antes. Este historial hace que la monitorización de actualizaciones forme parte de la configuración inicial, no sea una tarea opcional posterior.

El sitio web de Conduit aún indica que el proyecto está en fase beta y señala que faltan algunas funciones. Antes de elegirlo, compruebe que sus funciones actuales se ajusten a sus necesidades, especialmente si depende de puentes, administración avanzada o amplia compatibilidad con clientes. Una Raspberry Pi puede ser un host práctico para una implementación pequeña, pero el tráfico, el uso de medios y la actividad de federación afectan al rendimiento. Comience con un grupo de usuarios reducido y supervise el uso de memoria, temperatura y almacenamiento en lugar de confiar en un número de usuarios prometido.

¿Qué debes decidir antes de instalarlo?

  • Seleccione el nombre del servidor Matrix. En este ejemplo, es matrix.example.org. Este dominio aparece en los ID de Matrix de los usuarios, como @alex:matrix.example.org. Elija un dominio que controle y que planee conservar; cambiarlo posteriormente no es tan sencillo como editar el nombre de host.
  • Planifique el acceso público. Asigne al dominio un registro DNS que apunte a su dirección IP pública. Configure el reenvío del enrutador y un proxy inverso con un certificado HTTPS válido. La guía de implementación de Conduit exige HTTPS e indica que el tráfico de federación debe ser accesible a través del puerto 443 y/o 8448, según su configuración de descubrimiento y proxy.
  • Utilice Raspberry Pi OS de 64 bits. Compruebe la arquitectura con uname -m. Debería informar aarch64. La guía actual de Docker para Raspberry Pi señala que las futuras versiones principales de Docker Engine ya no proporcionan paquetes para Raspberry Pi OS de 32 bits; en ARM de 64 bits, dirige a los usuarios a arm64las instrucciones de instalación de Debian.
  • Mantenga la base de datos persistente. Almacene los datos de Conduit en un directorio persistente o en un volumen de Docker e inclúyalo en un plan de copia de seguridad probado. No almacene la única copia en la capa de escritura de un contenedor ni en una tarjeta extraíble que pueda formatearse.

¿Cómo se inicia Conduit con Docker?

Instala Docker Engine y el complemento Compose siguiendo las instrucciones vigentes para tu versión de Raspberry Pi OS. A continuación, confirma que Docker se esté ejecutando. La documentación de Conduit enumera la imagen estable de Docker Hub registry.gitlab.com/famedly/conduit/matrix-conduit:latesty las imágenes ARM64 OCI. Descarga la imagen estable y comprueba que Docker haya seleccionado una imagen ARM64.

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

Continúe solo si la arquitectura informada coincide con su sistema operativo de 64 bits. Cree un directorio de trabajo y un archivo Compose:

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

Utilice esta configuración como punto de partida. Se asume que el proxy inverso se ejecuta en el host Raspberry Pi y reenvía las solicitudes de Matrix al puerto 6167. Reemplace el nombre del servidor de ejemplo. El valor vacío CONDUIT_CONFIGindica al contenedor que utilice variables de entorno, tal como lo requieren las instrucciones actuales de Docker para Conduit.

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

Cree un archivo de token de registro privado e inicie el servicio:

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

El token es necesario para registrar tu primera cuenta; Conduit convierte al primer usuario creado en administrador del servidor. Mantén el .envarchivo privado y no lo subas a un repositorio público. El ejemplo vincula Conduit a la interfaz de bucle invertido de la Raspberry Pi, por lo que solo se puede acceder a él mediante un proxy inverso que se ejecute en el mismo host. Si tu proxy se ejecuta en otro contenedor o en otra máquina, utiliza una red Docker privada o una interfaz privada protegida en lugar de exponer el puerto 6167 públicamente.

¿Cómo se consigue que el servidor sea accesible y seguro?

Configure su proxy inverso para que sirva el dominio a través de HTTPS y reenvíe las solicitudes de cliente y federación de Matrix (incluidas /_matrix/las de y /.well-known/matrix/) a Conduit. La configuración pública más sencilla depende de su proxy y de si la federación utiliza el puerto 8448 o el descubrimiento delegado a través del puerto 443. Siga el ejemplo correspondiente en la documentación de implementación de Docker de Conduit; no copie un fragmento de proxy sin adaptar sus nombres de host, la gestión de certificados y las rutas de red.

Si utiliza el mismo dominio para server_namela URL del servidor principal, asegúrese de que los clientes puedan acceder al punto final HTTPS anunciado. Si Conduit se aloja en un subdominio distinto al del dominio Matrix ID, configure ambos /.well-known/matrix/clientcomo /.well-known/matrix/serverse describe en la guía de delegación. Abrir un puerto por sí solo no configura el descubrimiento ni TLS.

Registre su cuenta de administrador de inmediato con un cliente Matrix que admita tokens de registro. Luego, desactive el registro abierto a menos que desee que otros creen cuentas. En Compose, cambie CONDUIT_ALLOW_REGISTRATIONa "false", elimine el token de registro del entorno de servicio y vuelva a crear el contenedor con docker compose up -d. Su directorio de datos montado permanece en su lugar. Revise quién puede acceder al socket Docker y a los archivos de configuración de la Raspberry Pi, ya que pueden revelar o modificar secretos del servidor.

¿Cómo se puede confirmar que la configuración funciona?

Compruebe la API del cliente Matrix local a través del nombre de host HTTPS público:

curl -fsS https://matrix.example.org/_matrix/client/versions

Una respuesta JSON confirma que la API del cliente es accesible; no prueba que la federación funcione. Ejecute el probador oficial de Matrix Federation para el nombre de su servidor y corrija cualquier error de DNS, TLS, redireccionamiento de puertos o cualquier otro .well-knownerror que reporte. Finalmente, inicie sesión con su nueva cuenta, confirme que tiene acceso de administrador y pruebe un mensaje en una sala con un usuario en otro servidor si la federación forma parte de su objetivo.

Los detalles técnicos anteriores se verificaron con las páginas oficiales de Docker, configuración, delegación y registro de cambios de Conduit el 10 de octubre de 2026. Consulte la guía de implementación de Docker de Conduit , la guía de implementación binaria y genérica para ARM64 , la referencia de configuración , la guía de delegación , el registro de cambios de Conduit y las notas de instalación de Docker para Raspberry Pi OS para obtener detalles que varían según la versión.

Dejar un comentario

Restaura Matrix Synapse de forma segura con un volcado de PostgreSQL.

Realice una copia de seguridad de Synapse con pg_dump, proteja su clave de firma y el medio de almacenamiento, y restáurela en una base de datos PostgreSQL limpia sin reutilizar claves obsoletas de un solo uso.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Configura Mjölnir con una cuenta Matrix dedicada, una sala de administración cifrada, Docker Compose, una lista de políticas y comprobaciones de permisos.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Omita el proxy obsoleto y configure la sincronización deslizante integrada de Synapse. Verifique la detección de clientes y luego mida la carga de la lista de salas y el comportamiento de reconexión en un teléfono compatible.

Aloja Element Web en Nginx con un servidor Homeserver personalizado.

Implementa Element Web como un sitio estático, apúntalo a tu servidor principal Matrix, agrega HTTPS y configura Nginx para que sirva las actualizaciones sin archivos obsoletos.

Ejecuta un servidor doméstico Matrix ligero en Raspberry Pi 4

Configura Conduit en una Raspberry Pi 4 de 64 bits con datos persistentes, federación HTTPS, registro protegido y comprobaciones para un servidor doméstico en funcionamiento.

Configura un alias de sala Matrix personalizado en tu propio dominio.

Asigne a una sala de Matrix una dirección fácil de compartir en su dominio utilizando Element o la API de Matrix, con comprobaciones de permisos, nomenclatura Synapse y federación.

Configurar la función de devolución conjunta para llamadas de voz y vídeo fiables de Matrix.

Configure coturn y Synapse con las credenciales TURN correspondientes, abra los puertos de retransmisión necesarios y verifique que los clientes de Matrix puedan obtener candidatos de retransmisión.

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Configura un servidor Synapse persistente con Docker Compose, PostgreSQL, una configuración privada y comprobaciones antes de exponerlo a través de HTTPS.

Personaliza el tema y la imagen de marca de Element Web.

Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.