La instalación, paso a paso

Toda la instalación la hace un solo comando, ./draften install, ejecutado en el paquete descomprimido. Este es el procedimiento desde un servidor vacío hasta el primer inicio de sesión. Qué contiene una instalación y dónde está cada cosa se describe en Instalación en su propio servidor.

Paso 1: Prepare el servidor

• x86-64 con Linux (también sirve un Synology u otro NAS con Docker),
• Docker Engine 24 o posterior con el plugin compose; compruébelo con docker compose version,
• 4 GB de memoria y 20 GB de espacio en disco,
• las herramientas tar, base64 y sha256sum (o shasum), que tiene casi cualquier sistema.

El servidor no necesita internet para la instalación: el paquete trae todas las imágenes.

Paso 2: Compruebe que el paquete es nuestro

Para cada paquete de versión draften-<versión>.tar publicamos su suma de comprobación. Calcúlela y compárela:

sha256sum draften-<versión>.tar

Cada actualización posterior la comprueba la instalación por sí sola con nuestras claves. Pero la primera instalación no tiene con qué comparar: esta es su comprobación. Si las sumas no coinciden, no instale el paquete y póngase en contacto con nosotros.

Paso 3: Descomprima el paquete y ejecute el instalador

Elija el directorio en el que vivirá la instalación, descomprima en él el paquete y ejecute el instalador:

mkdir /srv/draften
tar -xf draften-<versión>.tar -C /srv/draften
cd /srv/draften
./draften install

El instalador carga las imágenes, comprueba el paquete y pregunta lo que necesita.

Paso 4: Responda a las preguntas del instalador

• La dirección en la que las personas abren draften, como https://draften.firma.cz. Debe ser la dirección que usan de verdad: con ella se construyen las direcciones de redirección para iniciar sesión con Microsoft y Google.
• La organización y su nombre corto (letras minúsculas, dígitos, guiones).
• El primer administrador: correo electrónico, nombre e idioma (cs o en). Pasa a ser el propietario de la organización y el operador de toda la instalación.
• El updater (sí / no): un servicio que permite actualizar, cambiar el número de procesos y sustituir la clave de cifrado desde la interfaz web. Tiene acceso a Docker, lo que equivale a derechos de root en esta máquina. Sin él, todo funciona desde la línea de comandos.
• El certificado HTTPS: el archivo del certificado y su clave (PEM), si HTTPS debe terminar directamente en draften. Déjelo vacío cuando un proxy inverso o un túnel delante de draften se encargue de HTTPS (consulte el paso 7).

Cada respuesta también se puede dar directamente en el comando, así que puede automatizar la instalación con un script; ./draften help muestra las opciones. Por ejemplo:

./draften install --url https://draften.firma.cz --org "Firma S.L." \
  --admin-email jan@firma.cz --admin-name "Jan Novák" --locale cs --updater yes

Paso 5: Guarde una copia de .env fuera del servidor

El instalador escribe la configuración y los secretos en el archivo .env del directorio de la instalación. Cópielo (como mínimo el valor de MASTER_KEY) a un lugar seguro fuera del servidor. Esta clave cifra el acceso a los buzones, las claves de los modelos y las contraseñas para enviar correo. Sin ella nadie puede leerlos, ni siquiera desde una copia de seguridad, y nosotros no la tenemos.

Paso 6: Establezca su contraseña e inicie sesión

Al final, el instalador muestra un enlace para establecer la contraseña del primer administrador. Ábralo en un navegador, establezca la contraseña y habrá iniciado sesión. El enlace funciona una sola vez y es válido durante 7 días. Cómo es la página de la contraseña lo muestra la guía «Iniciar sesión».

Solo el instalador muestra el enlace. No lo copie en ningún sitio ni lo reenvíe: quien lo tenga establece la contraseña del administrador.

Paso 7: Publique la dirección

Según lo que haya elegido en el paso 4:

• Con certificado, draften escucha él mismo en el puerto 443 y redirige del puerto 80 a HTTPS. Basta con que la dirección apunte a este servidor en el DNS.
• Sin certificado, draften escucha en 127.0.0.1:8085 y HTTPS lo termina su proxy inverso o su túnel delante de él. Si el proxy está en otra máquina, ponga WEB_BIND=0.0.0.0:8085 en .env.
• Con un Cloudflare Tunnel no hace falta ningún puerto abierto: ponga el token del túnel en .env (CLOUDFLARE_TUNNEL_TOKEN), añada tunnel a COMPOSE_PROFILES (por ejemplo, COMPOSE_PROFILES=updater,tunnel) y ejecute docker compose up -d. En Cloudflare, dirija el túnel a http://127.0.0.1:8085.

El certificado también se puede añadir más tarde:

./draften certificate cert.pem key.pem --url https://draften.firma.cz

Paso 8: Suba la licencia

Le enviamos la licencia como un archivo licence-<número>.json. En la interfaz, abra Instalación › Instalación, elija el archivo en la tarjeta Licencia, al final de la página, y súbalo. Mientras la instalación no tenga licencia, los asistentes no procesan correo y no se puede crear ningún buzón ni asistente. Más información en La licencia.

Paso 9: Configure las claves y el envío de correo predeterminados

En la misma página Instalación, configure las Claves de API predeterminadas para los modelos y el Envío de correo predeterminado (desde dónde salen las invitaciones y los enlaces de contraseña). Se aplican a todas las organizaciones que no configuren los suyos. Detalles: Claves de API de los modelos y Envío de correo.

Paso 10: Conecte un buzón y configure un asistente

A partir de aquí se continúa como en cualquier otra instalación:

1. Añada y conecte un buzón.
2. Configure un asistente con la configuración guiada.
3. Invite a más personas: Personas y roles.

Paso 11: Compruebe que todo funciona

./draften status

muestra la versión, el estado del servicio web y de los workers, el estado de HTTPS y los volcados de la base de datos. En la interfaz, la página Funcionamiento muestra si los workers se reportan; consulte Funcionamiento y capacidad.

Siguientes pasos

• «Actualizar con el updater»: una versión nueva con un solo botón,
• Actualizar desde la línea de comandos,
• Copia de seguridad y restauración,
• Solución de problemas.