Guía de instalación

La imagen en un servidor Linux

Construye la imagen, prepara el servidor e inicia el contenedor en tu dominio.

Construir la imagen

La imagen se construye en la máquina de desarrollo, con Docker Desktop en modo de contenedores Linux, y llega al servidor como archivo: el servidor no necesita ni un registro ni el código fuente.

  1. Desde la raíz del repositorio, ejecuta .\rebuild_container_release.ps1 -NoSeedData: construye la imagen, comprueba que no contenga fuentes y sí cada parte compilada, la inicia de prueba y la guarda como deploy\docker\merydion-allinone.tar con su huella.
  2. Copia la imagen y su huella al servidor, por ejemplo con scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. En el servidor, comprueba la huella y carga la imagen: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Consejo Sin -NoSeedData, la build empaqueta también merydion-data.tar.gz con los datos de la máquina de desarrollo — datos personales y clave privada del servicio de inicio de sesión incluidos: no es para una instalación nueva.

Preparar el servidor

En el servidor, conserva la disposición del repositorio: el archivo compose encuentra a sus vecinos por ruta relativa. Los archivos siguientes son del servidor, nunca de la imagen.

  1. Haz que el registro DNS de tu dominio apunte al servidor y abre los puertos 80 y 443 hacia Internet.
  2. En deploy/prod-allinone/Caddyfile, escribe un correo real en el bloque global: Let's Encrypt escribe ahí antes de que caduque un certificado.
  3. Crea deploy/prod-allinone/.env con MERYDION_DOMAIN=merydion.example.com y, para que salgan los correos de verificación, MERYDION_AUTH_SMTP_PASSWORD= seguido de la contraseña del buzón.
  4. Crea SERVER_SECRETS.json en la raíz del repositorio, legible solo por ti (chmod 600): ahí van los demás secretos de los servicios, y si no hay ninguno contiene { "services": {} } — sin el archivo, el contenedor no arranca.
  5. Escribe tu correo en ADMINISTRATORS, en la raíz del repositorio.

Consejo Un secreto nunca va en SERVER_CONFIGURATION.json, que está versionado y deja vacíos los campos secretos; la variable de un campo prevalece sobre SERVER_SECRETS.json.

Iniciar el contenedor

El contenedor incluye la pasarela, los servicios, el portal y las aplicaciones. Arranca desde la imagen cargada, sin construir nada en el servidor.

  1. Desde la raíz del repositorio: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Comprueba que funciona: docker compose -f deploy/prod-allinone/docker-compose.yml ps debe decir running, no restarting.
  3. En la primera visita Caddy obtiene el certificado, lo que tarda hasta un minuto: después curl -sS https://merydion.example.com/health responde ok.
  4. Si el contenedor se reinicia una y otra vez, un servicio se ha detenido y ha arrastrado a los demás: lee el motivo con docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Consejo Las videollamadas en este servidor necesitan además el puerto UDP del servicio multimedia y un relé TURN: el runbook de nodo único del repositorio describe los ajustes adicionales.

Volver a la guía

Productividad, made in Italy.

Lleva toda la suite a tu equipo: sencilla, segura y completamente tuya.