Solución de problemas
El servidor se niega a arrancar y menciona la seguridad a nivel de fila o el usuario de la base de datos
El servidor consulta Postgres con un usuario que no puede eludir la seguridad a nivel de fila, y se niega a arrancar (y explica por qué) si pudiera. Ocurre cuando el rol es superusuario, tiene BYPASSRLS, es miembro de un rol así, o es propietario de tablas con seguridad a nivel de fila. También ocurre cuando hay un usuario de migración configurado y el usuario de ejecución aún podría cambiar a un rol privilegiado.
Con el Postgres incluido esto es automático, así que comprueba que no hayas sobrescrito CAMPBOOKS_DATABASE_URL. Con tu propio Postgres, crea el usuario de ejecución como se describe en Almacenamiento y base de datos.
Si aún no puedes separar los usuarios, puedes arrancar de todos modos:
CAMPBOOKS_DATABASE_ALLOW_RLS_BYPASS=true
El aislamiento de los espacios de trabajo depende entonces solo de las consultas. Considéralo algo temporal.
El servicio laya se niega a arrancar
laya-serve responde a cualquiera cuando no tiene clave, así que el servicio laya se niega a arrancar hasta que CAMPBOOKS_AI__DECIDE__API_KEY esté definida en .env. Genera una, defínela y vuelve a iniciar:
openssl rand -hex 32
docker compose --profile ai up -d
Consulta IA local.
El servicio de embeddings no funciona en mi máquina ARM
La compilación para CPU del servidor de embeddings de texto se publica solo para linux/amd64. En arm64, elimina el servicio embeddings y apunta el rol embed a Ollama con el modelo bge-m3. Consulta IA local.
La generación de IA es muy lenta
La inferencia en CPU funciona pero es lenta para el rol complete. Usa un host con GPU, o un proveedor alojado que sirva modelos de pesos abiertos, y define su URL en .env. Los roles decide (Laya) y embed funcionan bien en CPU. Consulta IA local.
Las invitaciones no llegan por correo
Las invitaciones aún no se envían por correo. Quien invita recibe el enlace una sola vez, justo después de invitar, para que lo envíe. El enlace se construye con CAMPBOOKS_PUBLIC_URL, así que define ahí la dirección que usa la gente de verdad. Consulta Inicio de sesión.
El servidor no arranca con almacenamiento S3
Con CAMPBOOKS_BLOBS__BACKEND=s3 el servidor comprueba al arrancar que llega al bucket y se niega a arrancar si no. Revisa el endpoint, la región, las claves y CAMPBOOKS_BLOBS__S3__PATH_STYLE. Consulta Almacenamiento y base de datos.