Guía de instalación

Primer inicio de sesión y operación

El primer administrador, las actualizaciones, las copias de seguridad, el coming soon y la política de seguridad.

El primer administrador

El registro solo está abierto a quien tiene un código de invitación, y los códigos se generan en la consola — que aún nadie puede abrir. El primer código se genera en la propia máquina.

  1. Imagen: en el servidor, desde la raíz del repositorio, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Carpeta: en PowerShell, dentro de la carpeta, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. El comando muestra un código con la forma XXXX-XXXX-XXXX; invite-code 5 muestra cinco.
  4. En el portal, haz clic en Iniciar sesión y luego en Crear cuenta: introduce el código, regístrate con el correo escrito en ADMINISTRATORS y confírmalo con el código del correo de verificación.
  5. Inicia sesión: Diagnóstico, al pie de cada página, abre la consola, donde se generan los demás códigos de invitación.

Consejo Si el correo de verificación no llega, revisa la contraseña del buzón: el servicio de inicio de sesión avisa al arrancar cuando falta.

Actualizar

Una actualización sustituye la imagen y conserva los datos: viven en el volumen del contenedor, que pertenece al proyecto y no a la imagen.

  1. En la máquina de desarrollo, con el repositorio actualizado, construye la nueva imagen: .\rebuild_container_release.ps1 -NoSeedData.
  2. Cópiala al servidor, compruébala y cárgala como la primera vez: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Inicia con el mismo comando que la primera vez: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d detecta la nueva imagen y vuelve a crear el contenedor, con una interrupción de pocos segundos.
  4. Abre la consola en la pestaña Actualización: donde una fila diga Actualización disponible, haz clic en Ejecutar actualización — hasta entonces las funciones de datos de ese servicio siguen apagadas.

Consejo Antes de cada actualización, comprueba en el diagnóstico que las copias de las bases de datos estén bien (la tarjeta «Copias de las bases de datos») y copia los archivos: la actualización de las bases de datos trabaja sobre una copia y conserva el original hasta verificarla, pero las copias son tu propio camino de vuelta.

Copias y restauración

Cada servicio mantiene una copia continua de las bases de datos que gestiona — cuentas, índices de documentos, correo, chats — con un retraso máximo de alrededor de un segundo, y puede restaurarla a cualquier instante de los últimos siete días. Los archivos propiamente dichos — documentos, adjuntos, vistas previas — se escriben una vez y no cambian nunca: se copian aparte o se guardan en un bucket de S3.

  1. Saca las copias de las bases de datos de la máquina: registra un destino de la clase backups en un bucket de S3 o en otro disco, y actívalo.
  2. Imagen: copia los archivos, sin las bases de datos, mientras está en marcha: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' escribe un archivo con fecha en la carpeta files.
  3. Carpeta: detenla con .\stop.ps1, copia entera la carpeta data y vuelve a iniciarla.
  4. Si un administrador ha registrado otro destino para los archivos, copia su carpeta en la misma pasada: los archivos creados tras su activación solo están allí.
  5. Guarda las copias lejos de la máquina que protegen.

Consejo Para devolver una base de datos o la instalación entera al estado de un instante dado, detén la instalación y ejecuta merydion-storage copies restore (el procedimiento «Copias y restauración» del runbook): el comando escribe las bases de datos restauradas en una carpeta nueva, que después ocupa el lugar de la antigua.

Poner el sitio en coming soon

El coming soon muestra a cada visitante solo una página de vista previa mientras se prepara la instalación: el portal, las aplicaciones, Palatys y la consola esperan detrás, también para los administradores.

  1. Inicia sesión como administrador y abre https://merydion.example.com/coming-soon.html?enabled=true: la página lo confirma y el sitio queda en coming soon.
  2. Para volver a encender el sitio, abre https://merydion.example.com/coming-soon.html?enabled=false: tras la confirmación la página te lleva al inicio.
  3. Si no has iniciado sesión, la página te lo pide primero; a una cuenta que no es administradora se lo dice, y no cambia nada.
  4. El estado es el archivo site/coming-soon en la carpeta de datos: quitarlo vuelve a encender el sitio incluso sin la página.

Consejo La página del coming soon existe en inglés y en italiano; a un visitante de otro idioma le llega la inglesa.

Activar las estadísticas de visitas

El sitio puede contar sus visitas con Google Analytics 4, pidiendo antes el consentimiento a cada visitante: mientras un visitante no acepta, no se carga nada de Google. Las estadísticas siguen desactivadas hasta que la instalación indica su ID de medición, y la consola de administración nunca las tiene.

  1. En Google Analytics, crea una propiedad y un flujo de datos web para la dirección del sitio, y copia su ID de medición (empieza por G-).
  2. Imagen: en el archivo .env junto a docker-compose.yml añade MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX y vuelve a crear el contenedor con docker compose up -d. Carpeta: exporta la misma variable en la sesión antes de start.ps1.
  3. Abre el sitio en una ventana privada: abajo a la izquierda aparece el aviso de estadísticas de visitas, y al pie de cada página aparece «Preferencias de cookies».
  4. Para desactivar las estadísticas, vacía la variable y vuelve a crear el contenedor: el aviso desaparece, y los navegadores de quienes habían aceptado dejan de cargar Google Analytics.

Consejo La política de privacidad y la política de cookies ya describen las estadísticas, en todos los idiomas, para la instalación que las activa. En la propiedad, configura la conservación de datos que quieras —Google guarda los datos de una visita como máximo 14 meses— y deja desactivadas las señales de Google: el sitio también las desactiva por su parte.

Abrir el sitio a los motores de búsqueda

Cada instalación indica a los motores de búsqueda que no la indexen hasta que active la indexación: una copia del sitio que no es la oficial —una instalación de prueba, la de una organización— nunca le hace competencia en los resultados. Las direcciones que declaran las páginas, las vistas previas y los mapas del sitio son las del sitio oficial, https://merydion.eu, y las páginas de la cuenta, la consola y la página de una dirección que no existe nunca entran en un índice.

  1. Solo en la instalación que sirve el sitio oficial. Imagen: en el archivo .env junto a docker-compose.yml añade MERYDION_SITE_INDEXING=1 y vuelve a crear el contenedor con docker compose up -d. Carpeta: exporta la misma variable en la sesión antes de start.ps1.
  2. Compruébalo: curl -I https://merydion.eu/ ya no muestra la cabecera X-Robots-Tag: noindex, y https://merydion.eu/robots.txt apunta a https://merydion.eu/sitemap.xml.
  3. En Google Search Console y en Bing Webmaster Tools, verifica el dominio con un registro DNS y envía https://merydion.eu/sitemap.xml.
  4. Para quitar de nuevo el sitio de los motores de búsqueda, vacía la variable y vuelve a crear el contenedor: cada respuesta dice otra vez noindex, y los motores retiran las páginas en su próxima visita.

Consejo Un portal generado para otra dirección define MERYDION_SITE_ORIGIN (por ejemplo https://www.example.com) al generarse: las direcciones canónicas, las variantes de idioma, las vistas previas y los mapas del sitio usan entonces esa dirección. La página de una dirección que no existe responde en el idioma de su carpeta, con el estado 404.

La Content-Security-Policy del portal

Las páginas del portal funcionan bajo una Content-Security-Policy estricta que envía la pasarela: una página solo puede usar sus propios archivos, peticiones a su propio origen, imágenes también desde data: y blob:, y ningún marco de otro sitio. Es lo que impide que un fragmento de marcado intruso ejecute código. La única excepción son las estadísticas de visitas: las páginas que pueden contar visitas admiten también gtag.js de Google, solo en su ruta, y la recopilación de Google Analytics, que se cargan solo después de que un visitante acepte.

  1. Un portal personalizado con scripts o estilos escritos dentro de sus páginas no funciona: los scripts y los estilos van en archivos propios.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE y window.MERYDION_DIAGNOSTICS_BASE solo pueden mover una familia de peticiones bajo otra ruta del mismo origen; una dirección en otro origen se ignora, con un error en la consola del navegador.
  3. Las páginas de la consola de la instalación llevan la política sin la excepción de las estadísticas y, además, no se pueden mostrar dentro de un marco.
  4. La política vive en apps/portal-csp.mjs y en los tres Caddyfile, y una prueba los mantiene iguales: cámbiala en los cuatro sitios a la vez.

Consejo El formulario de inicio de sesión del servicio de identidad y la página de rechazo de la consola llegan con una política propia, aún más estricta.

Volver a la guía

Productividad, made in Italy.

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