Instalación web
Después de iniciar Sayrud con un binario, Docker Compose o Kubernetes, abre http://server-address:2830/setup. Antes de la instalación, la página principal también redirige aquí.
La instalación consta de cuatro pasos: verificación, base de datos, administrador y finalización. Puedes cambiar el idioma en la esquina superior derecha.
Verificar tu identidad
Si no se especifica un token, los registros de inicio muestran Setup token: y un enlace de instalación con el token. Cópialo en la página y pulsa «Verificar». En despliegues remotos, sustituye localhost en el enlace por la dirección real.
| Método de despliegue | Dónde consultar los registros |
|---|---|
| Proceso en primer plano | Terminal actual |
| systemd | sudo journalctl -u sayrud -n 100 --no-pager |
| Docker Compose | docker compose logs --tail=100 sayrud |
| Kubernetes | kubectl -n sayrud logs deployment/sayrud --tail=100 |
Si se ha configurado SAYRUD_SETUP_TOKEN, introduce su valor. Las instrucciones de K8s usan este método; el token está en el archivo local usado para crear el Secret.
Un token personalizado debe tener al menos 16 caracteres sin contar espacios ni guiones. Puedes generarlo con openssl rand -hex 24. La verificación no distingue mayúsculas y minúsculas e ignora espacios y guiones.
Si no fijas el token, reiniciar el proceso durante la instalación genera uno nuevo. Consúltalo en los registros más recientes. Comparte el token y el enlace que lo contiene solo con la persona encargada de la instalación; los endpoints de instalación se cierran al crear el administrador.
Configurar las bases de datos
Para una instalación nueva, introduce lo siguiente:
| Servicio | Campos |
|---|---|
| PostgreSQL | Host, puerto, nombre de la base de datos, usuario, contraseña, modo SSL |
| Redis | Dirección en formato host:puerto y, opcionalmente, usuario y contraseña |
Las conexiones salen del proceso de Sayrud, no del equipo donde abres el navegador. La configuración de Docker Compose usa postgres y redis:6379; K8s usa nombres de Service del clúster o dominios externos accesibles.
Los modos SSL de PostgreSQL son «Sin cifrado», «Cifrado», «Cifrado, verificar CA» y «Cifrado, verificar CA y nombre de host». Elige el que requiera tu servicio de base de datos. Para verificar certificados, el entorno de ejecución también debe confiar en la CA correspondiente.
Pulsa «Probar conexión», comprueba que PostgreSQL y Redis se conectan correctamente y pulsa «Guardar y continuar».
Crear el administrador
Introduce el correo electrónico, el usuario, la contraseña y su confirmación, y pulsa «Completar instalación».
Se creará el primer administrador del sistema y se iniciará sesión automáticamente. Pulsa «Empezar» para entrar en la aplicación.
Tras la instalación, comprueba que puedes crear proyectos, editar registros y subir adjuntos, y que tu despliegue conserva la configuración y los archivos subidos. Los ajustes del sitio, el registro de usuarios, los métodos de inicio de sesión y los modelos de IA se gestionan desde el panel de administración.
Proporcionar la configuración de antemano
Si un sistema de gestión de configuración proporciona los datos de conexión, puedes preparar sayrud.yaml de antemano. Esta configuración usa almacenamiento local; sustituye primero la contraseña de conexión y auth.secret_key:
postgres:
dsn: "postgres://sayrud:[email protected]:5432/sayrud?sslmode=disable"
redis:
address: "127.0.0.1:6379"
username: ""
password: ""
auth:
secret_key: "REPLACE_WITH_BASE64_KEY"
storage:
type: local
local:
path: ./data/storageGenera auth.secret_key con este comando e introduce toda la salida en la configuración:
openssl rand -base64 32Al escribir una URL de PostgreSQL a mano, codifica para URL los caracteres especiales de la contraseña, como @, : y /. El asistente se encarga de la codificación si introduces los datos en él.
Coloca el archivo en la ruta indicada por los argumentos de inicio. Consulta el resto de las opciones en la configuración de ejemplo. Reinicia el programa después de cambiar la configuración.
Resolución de problemas
No aparece la página de instalación
Si los registros muestran un inicio correcto y ya hay usuarios en la base de datos, el programa muestra la aplicación directamente. Inicia sesión con una cuenta existente.
El token de instalación no es válido
Comprueba si el proceso se reinició durante la instalación. Si no se ha configurado SAYRUD_SETUP_TOKEN, usa el token de los registros más recientes. En K8s, comprueba que el Pod usa el Secret previsto y mantén una sola réplica durante la instalación inicial. Varios intentos incorrectos activan el límite de solicitudes; verifica el token antes de volver a intentarlo.
Falla la prueba de conexión a la base de datos
Comprueba que la base de datos existe, que las credenciales son correctas y que el host o Pod de la aplicación puede acceder a la dirección. En un contenedor, 127.0.0.1 apunta al propio contenedor. Si la conexión funciona pero falla el guardado, comprueba también los permisos para migrar el esquema.
El asistente de una instalación nueva no permite usar una base de datos que ya tenga usuarios. Para restaurar una instancia, recupera su configuración, clave y archivos originales y conéctala a la base de datos mediante el inicio normal, sin repetir el paso de configuración de la base de datos.
Error de permisos al guardar la configuración
El asistente escribe un archivo temporal en el directorio de configuración antes de guardarlo como sayrud.yaml, por lo que el directorio debe permitir la escritura. Comprueba si hay montajes de solo lectura, ConfigMaps, Secrets o diferencias entre el UID/GID del proceso y el propietario del volumen. Las imágenes de Docker y K8s usan 10001:10001.
La configuración se ha guardado, pero se solicita reiniciar
Consulta los registros, resuelve el fallo posterior de inicialización y reinicia con la misma ruta de configuración. El archivo guardado se volverá a leer; no hace falta borrarlo ni reinstalar.
La página de instalación reaparece al recrear el contenedor
Comprueba que el directorio de configuración se monta en /home/app/config, que sigues usando la base de datos PostgreSQL original y que no han cambiado el nombre del proyecto de Compose o el PVC de K8s. Recupera la configuración y los datos originales antes de iniciar otra instalación.