Resolução de problemas

O servidor recusa-se a arrancar e menciona segurança ao nível da linha ou a conta da base de dados

O servidor consulta o Postgres com uma conta que não consegue contornar a segurança ao nível da linha e recusa-se a arrancar (e diz porquê) se conseguisse. Isto acontece quando o papel é um superutilizador, tem BYPASSRLS, é membro de um papel desses, ou possui tabelas com segurança ao nível da linha. Acontece também quando há uma conta de migração configurada e a conta de execução ainda poderia mudar para um papel privilegiado.

Com o Postgres incluído isto é automático, por isso verifique que não substituiu CAMPBOOKS_DATABASE_URL. Com o seu próprio Postgres, crie a conta de execução como descrito em Armazenamento e base de dados.

Se ainda não consegue separar as contas, pode arrancar na mesma:

CAMPBOOKS_DATABASE_ALLOW_RLS_BYPASS=true

O isolamento dos espaços de trabalho passa então a depender só das consultas. Trate isto como temporário.

O serviço laya recusa-se a arrancar

O laya-serve responde a qualquer pessoa quando não tem chave, por isso o serviço laya recusa-se a arrancar até CAMPBOOKS_AI__DECIDE__API_KEY estar definida no .env. Gere uma, defina-a e arranque de novo:

openssl rand -hex 32
docker compose --profile ai up -d

Veja IA local.

O serviço de embeddings não corre na minha máquina ARM

A versão para CPU do servidor de embeddings de texto é publicada apenas para linux/amd64. Em arm64, retire o serviço embeddings e aponte o papel embed para o Ollama com o modelo bge-m3. Veja IA local.

A geração de IA é muito lenta

A inferência em CPU funciona, mas é lenta para o papel complete. Use uma máquina com GPU, ou um fornecedor alojado que sirva modelos de pesos abertos, e defina o respetivo URL no .env. Os papéis decide (Laya) e embed correm bem em CPU. Veja IA local.

Os convites não chegam por email

Os convites ainda não são enviados por email. Quem convida recebe a ligação uma só vez, logo após convidar, para a enviar. A ligação é construída a partir de CAMPBOOKS_PUBLIC_URL, por isso defina-o com o endereço que as pessoas realmente usam. Veja Início de sessão.

O servidor não arranca com armazenamento S3

Com CAMPBOOKS_BLOBS__BACKEND=s3, o servidor verifica no arranque se consegue chegar ao bucket e recusa-se a arrancar caso contrário. Verifique o endpoint, a região, as chaves e CAMPBOOKS_BLOBS__S3__PATH_STYLE. Veja Armazenamento e base de dados.