Instalación Docker

Configura tu servidor Matrix privado en minutos

Esta guía te ayudará a configurar un servidor Matrix completo usando Docker. Tendrás tu propio directorio privado para Krill App.

Requisitos Previos

Un servidor o computadora que pueda ejecutarse 24/7
Docker y Docker Compose instalados
Un nombre de dominio (opcional, para federación)
Conocimiento básico de línea de comandos

1 Instalar Docker

macOS

Descarga Docker Desktop desde docker.com o usa Homebrew:

brew install --cask docker

Linux

Instala Docker Engine usando el script oficial:

curl -fsSL https://get.docker.com | sh

Verificar instalación:

docker --version && docker-compose --version

2 Configurar Servidor Matrix

Proporcionamos un script que configura todo:

Descarga nuestro script de configuración:

git clone https://github.com/krillbot/matrix-docker-setup.git
cd matrix-docker-setup

Ejecuta la configuración:

./setup.sh

Sigue las instrucciones para configurar tu servidor.

3 Configurar Gateway

Apunta tu Gateway a tu nuevo servidor Matrix:

channels:
  matrix:
    enabled: true
    homeserver: "https://matrix.tu-dominio.com"
    userId: "@admin:tu-dominio.com"
    accessToken: "tu_token_generado"
    roomId: "!room-id:tu-dominio.com"

4 Verificar Configuración

Prueba que todo funciona:

El servidor Matrix está corriendo: visita https://tu-dominio/_matrix/client/versions
El Gateway conecta: ejecuta clawdbot gateway status
La app puede vincularse: escanea el código QR del Gateway

Solución de Problemas

¿El contenedor no arranca? +

Revisa los logs con: docker-compose logs -f

¿No puedes conectar desde fuera? +

Verifica que los puertos 443 y 8448 estén abiertos en tu firewall.

¿La federación no funciona? +

Asegúrate de que tu dominio tenga los registros SRV correctos.

¡Todo Listo!

Tu servidor Matrix privado está listo. Descarga la Krill App y vincúlala con tu Gateway.

Descargar Krill App

¿Necesitas ayuda?

Únete a nuestro Discord