O que é
O NocoDB é um banco de dados que você usa pelo navegador, com tabelas no estilo planilha: colunas com tipo (texto, número, e-mail, telefone, data, anexo, seleção), filtros, visões em grade, kanban, galeria e formulário, e convite para a equipe. É a mesma ideia do Airtable e do Baserow, só que no seu servidor e bem mais leve que o Baserow.
O que faz dele uma peça de estrutura, e não só mais uma ferramenta, é o que vem junto: cada instalação ganha um banco PostgreSQL próprio, com a extensão pgvector ligada, que já aparece dentro do NocoDB. O que o n8n ou um agente de IA grava nesse banco aparece nas tabelas da tela, e a tabela que você cria na tela vira uma tabela de verdade no banco, com o nome que você deu. Um lugar só para os dados do negócio: a equipe vê e edita pela planilha, as automações leem e escrevem direto no banco.
Requisitos
Parado, o NocoDB usa cerca de 550 MB de RAM e, nos picos, perto de 650 MB. O painel limita o contêiner a 30% da memória do servidor, entre 1 GB e 2 GB, e avisa (sem bloquear) em servidor com menos de ~2 GB. A imagem tem ~240 MB; o instalador pede 3 GB livres em disco antes de baixar.
Use HTTPS: sem certificado, a senha trafega aberta. Instale com SSL ou ative depois na aba SSL (ver Gerenciando uma aplicação).
O que a instalação monta
| Peça | Para quê |
|---|---|
contêiner nocodb |
a tela, a API e o MCP do NocoDB, publicados pelo nginx do servidor |
banco dados_<seu_dominio> |
o seu banco de dados, com pgvector; é ele que aparece no NocoDB e que o n8n usa |
banco nocodb_<seu_dominio> |
os bastidores do NocoDB (usuários, bases, visões); não mexa |
Os dois bancos ficam no PostgreSQL do servidor (gws-postgres), cada um com usuário e senha
próprios. Isso é de propósito: quem tem a senha do banco de dados (o seu n8n, um freelancer, uma
ferramenta de relatório) não enxerga os usuários, as senhas e os tokens do NocoDB. E nenhum dos
dois aceita conexão de usuário de outra aplicação.
Instalando
No formulário de instalação (ver Instalando uma aplicação), dois campos são do NocoDB:
- E-mail do administrador (obrigatório): é o seu login no NocoDB. A senha é gerada na instalação.
- Versão: o botão Mostrar versao latest atual busca a última versão publicada e Usar esta fixa o número. Com a versão fixa, atualizar é uma decisão sua.
SMTP é opcional: com ele, o NocoDB manda os convites e a recuperação de senha por e-mail.
Primeiro acesso
Abra Aplicações → seu NocoDB → Visão Geral. No card Acesso ao NocoDB estão o e-mail e a
senha do administrador (botões Mostrar e Copiar). Entre em https://seu-dominio com
eles.
- Trocou a senha dentro do NocoDB? A de lá passa a valer, e o painel continua mostrando a inicial.
- Esqueceu a senha? Clique em Redefinir a senha do administrador. O NocoDB reinicia duas vezes (cerca de 1 minuto) e a senha nova aparece no mesmo card.
- Cadastro só por convite: ninguém cria conta sozinho no seu NocoDB. Convide a equipe pelo próprio NocoDB (sem SMTP, copie o link do convite e mande para a pessoa).
A base “Banco de dados” e as suas tabelas
Ao entrar, você encontra a base Banco de dados, ligada ao seu banco dados_…. Crie as
tabelas dentro dela: elas nascem como tabelas reais no PostgreSQL e o n8n enxerga na hora.
Tabela criada por fora (pelo n8n, por um SQL, por um sistema seu) aparece no NocoDB depois de
sincronizar os metadados da base (no menu da base, dentro do NocoDB). Colunas do tipo vector
aparecem como um tipo específico do banco; servem para a IA, não para editar na mão.
Conectando o n8n, agentes de IA e sistemas
No card Banco de dados (PostgreSQL + pgvector) da Visão Geral estão host, porta, banco,
usuário, senha e a URL de conexão (postgresql://…), com botão de copiar.
- n8n: crie uma credencial Postgres com esses dados (host
gws-postgres, porta 5432, SSL desligado). Os nós Postgres leem e gravam nas mesmas tabelas que a equipe vê no NocoDB. - Memória e busca para agentes de IA: o nó Postgres PGVector Store do n8n já encontra a
extensão
vectorligada. Para muitos projetos de RAG, isso dispensa um banco vetorial separado (para volumes grandes, o Qdrant segue sendo a opção). - Typebot e outras aplicações do servidor: o mesmo host
gws-postgres.
O banco não fica aberto na internet: só as aplicações deste servidor alcançam o gws-postgres.
Para acessar do seu computador (um cliente SQL, uma ferramenta de BI), use um túnel SSH até a
porta 5432 do servidor. Para olhar e editar pelo navegador, a aba Banco abre o Adminer já
conectado aos dois bancos.
Anexos, importação e ajustes
Os anexos ficam no servidor, em /var/www/seu-dominio/data. O padrão é 20 MB por anexo e
100 MB por importação de CSV ou Excel. Para mudar, use as linhas comentadas que já vêm na aba
Ambiente (NC_ATTACHMENT_FIELD_SIZE, NC_DATA_IMPORT_FILE_SIZE, e as do S3, para guardar os
anexos num bucket). O que você muda abaixo da linha VARIAVEIS DO USUARIO sobrevive a atualização,
troca de SSL e reinstalação.
Não altere NC_CONNECTION_ENCRYPT_KEY nem NC_DB: a primeira cifra, dentro do NocoDB, a senha do
seu banco de dados; trocada, a base Banco de dados perde a conexão. As duas estão no
CREDENCIAIS.txt e entram no backup.
Backup e atualização
Pela aba Backup, como as outras aplicações (ver Backup global). Entram os dois bancos (o seu banco de dados e os bastidores do NocoDB), os anexos e o ambiente com as chaves. A restauração e a migração para outro servidor devolvem tudo ligado: as tabelas, os usuários do NocoDB e a conexão do n8n continuam funcionando com as mesmas senhas.
Para atualizar, use a aba Atualizar (ver Gerenciando uma aplicação). O NocoDB aplica as próprias mudanças de banco ao subir a versão nova; faça um backup antes.
