Base de Conhecimento

NocoDB na VPS: como instalar com Docker

  • nocodb na vps, nocodb, banco de dados, docker, vps
  • Usuários acharam útil: 0

Aprenda a instalar o NocoDB no seu servidor com Docker Compose e PostgreSQL, criar a conta de super admin, ligar o HTTPS, atualizar e fazer o backup do banco.

Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: NocoDB na VPS: como instalar com Docker

Capa da Redação Eleven Host para o tutorial: NocoDB na VPS: como instalar com Docker Arte: Eleven Host

O NocoDB na VPS é uma ferramenta para montar bancos de dados online. Você instala com Docker Compose, com PostgreSQL, e acessa pelo navegador na porta 8080.

O que é o NocoDB e qual é a licença

O NocoDB se apresenta como o jeito mais rápido e fácil de construir bancos de dados online. A documentação de instalação própria descreve a ideia de hospedar na sua infraestrutura e manter o controle dos seus dados.

Hospedando o NocoDB você mesmo, os dados e a configuração ficam no seu servidor. Em troca, atualização, backup e proteção do acesso passam a ser com você.

Sobre a licença, o README do projeto no GitHub diz que o NocoDB usa a Sustainable Use License, versão 1.0. Segundo o texto da licença, você pode usar ou modificar o software apenas para os seus próprios fins internos de negócio ou para uso pessoal e sem fins comerciais. A distribuição para outras pessoas só é permitida de forma gratuita e sem fins comerciais. Por isso, o foco aqui é o uso próprio, e não oferecer o NocoDB a terceiros. Em caso de dúvida sobre uso comercial, consulte um profissional.

Requisitos do NocoDB antes de começar

Se você está conhecendo servidores agora, leia primeiro o guia de iniciantes sobre servidor VPS. Depois, confira o que o NocoDB pede para rodar.

A documentação de self-hosting traz esta tabela de recursos para o NocoDB:

  • Processador: mínimo de 2 vCPU, recomendado para produção 4 vCPU.
  • Memória: mínimo de 2 GB, recomendado para produção 8 GB.
  • Disco: mínimo de 10 GB, recomendado para produção 50 GB ou mais.

Esses números são requisitos do NocoDB. Compare com o plano que você escolher na loja antes de contratar. Além deles, a documentação pede o Docker com o plugin Compose v2 e, para o instalador oficial, as portas 80 e 443 acessíveis. Para produção, a documentação recomenda Linux.

A documentação descreve quatro caminhos: início rápido para teste local, instalação em um servidor com HTTPS, infraestrutura personalizada (com PostgreSQL gerenciado) e métodos da comunidade.

Opção 1: instalador oficial, em três passos

A documentação mostra o instalador por curl executado direto no bash, mas ela mesma recomenda revisar antes de rodar. Prefira esta forma: baixar, ler e só então executar.

curl -fsSL https://install.nocodb.com/noco.sh -o noco.sh

less noco.sh

bash noco.sh

O instalador pergunta o domínio, se o PostgreSQL e o Redis serão embutidos ou já existentes, e o e-mail para o Let's Encrypt. Segundo a documentação, ele grava tudo na pasta nocodb/ e sobe os serviços.

Se você informar um domínio real, o instalador usa o Traefik e emite o certificado HTTPS automaticamente. Antes disso, crie um registro A apontando o domínio para o IP da VPS. Se deixar o domínio em branco, o NocoDB sobe em modo local, na porta 8080 e sem SSL. Com um IP puro, ele abre em HTTP na porta 80, também sem SSL.

Depois da instalação, a documentação manda proteger os arquivos de segredos:

cd nocodb

chmod 600 docker.env nocodb/db.json

Ela sugere também liberar só o necessário no firewall:

sudo ufw allow OpenSSH && sudo ufw allow 80,443/tcp && sudo ufw enable

Se você pretende usar o seu próprio proxy, escolha a opção seguinte, já que o instalador usa o Traefik nas portas 80 e 443 quando há domínio real.

Onde instalar o NocoDB

Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Opção 2: Docker Compose manual com PostgreSQL

Nesta opção, você copia o arquivo docker-compose.yml do exemplo quickstart-demo, que fica na pasta docker-compose/examples do repositório oficial do NocoDB no GitHub, para uma pasta vazia do servidor. Depois, ajuste os valores e suba. O exemplo define quatro serviços: nocodb, worker (a mesma imagem, com NC_WORKER_CONTAINER: 'true'), db (PostgreSQL) e redis.

O trecho principal do serviço nocodb é este:

nocodb:

image: nocodb/nocodb:latest

environment:

NC_DB: 'pg://db:5432?u=nocodb&p=quickstart_demo_pw_change_me&d=nocodb'

NC_REDIS_URL: 'redis://redis:6379'

NC_SITE_URL: 'http://localhost:8080'

NC_DISABLE_MUX: 'true'

ports:

- '8080:8080'

volumes:

- nocodb_data:/usr/app/data

Antes de subir, faça estes ajustes:

  • Troque a senha de exemplo. O texto quickstart_demo_pw_change_me é um valor público, e o próprio nome pede a troca. Use a mesma senha nova no NC_DB do nocodb, no NC_DB do worker e em POSTGRES_PASSWORD do serviço db.
  • Defina um segredo próprio. Acrescente a variável NC_AUTH_JWT_SECRET, que a documentação descreve como o segredo usado para gerar os tokens de autenticação. Gere um valor aleatório seu e não copie o do README.
  • Ajuste o endereço público. Troque NC_SITE_URL pelo endereço final com https, por exemplo https://nocodb.exemplo.com. A documentação diz que essa variável é necessária para os e-mails de saída, e os links de convite e de redefinição de senha são montados a partir dela. Com localhost, esses links saem errados.

Depois, suba os serviços:

docker compose up -d

Atrás de um proxy, publique a porta só no próprio servidor, trocando '8080:8080' por '127.0.0.1:8080:8080'. Essa é uma adaptação nossa: com ela, o NocoDB só recebe acesso pelo proxy, e não direto pela internet.

Checklist antes do primeiro acesso

  • Troquei a senha de exemplo nos três lugares.
  • Defini um NC_AUTH_JWT_SECRET só meu.
  • Troquei o NC_SITE_URL pelo endereço com https.
  • Publiquei a porta como 127.0.0.1:8080:8080 se vou usar proxy.
  • Guardei as senhas num lugar seguro, fora do servidor.

Primeiro acesso e conta de super admin

Com os contêineres no ar, abra o NocoDB no navegador (na porta 8080, ou no seu domínio) e cadastre e-mail e senha. Segundo a documentação, o primeiro usuário cadastrado vira super admin.

Na prática, isso significa que quem chegar primeiro na tela de cadastro controla a instalação. Por isso, crie a sua conta logo depois de subir, antes de divulgar o endereço. Se preferir, defina o super admin já na configuração, com as variáveis NC_ADMIN_EMAIL e NC_ADMIN_PASSWORD; a senha precisa ter pelo menos 8 caracteres, com uma letra maiúscula, um número e um caractere especial.

Para impedir cadastros abertos, a documentação traz a variável NC_INVITE_ONLY_SIGNUP, que desativa o cadastro público e deixa as pessoas entrarem só por convite.

HTTPS com um proxy reverso

Para abrir o NocoDB em https://nocodb.exemplo.com, coloque um proxy reverso na frente da porta 8080. Essa é uma adaptação nossa, não uma instrução da documentação: o proxy cuida do certificado e encaminha o acesso para o NocoDB.

O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para isso. Se preferir um servidor web com certificado automático, veja o Caddy na VPS. Para acompanhar e reiniciar os contêineres pelo navegador, o guia do Portainer na VPS ajuda.

Uma observação sobre filtros de saída: segundo a documentação, o NocoDB consulta o endereço app.nocodb.com pela porta 443 a cada 6 horas para verificar a licença. Se você restringir as conexões de saída do servidor, libere esse acesso.

Atualizar o NocoDB

Na versão 2026.10.1, marcada na página de releases do GitHub como correção de bugs e publicada em 29 de outubro, o formato de versão segue a data. A imagem do exemplo usa a etiqueta latest; a documentação do instalador permite fixar uma versão com a opção --image-tag=. Recomendamos fixar a versão.

Se você usou o instalador, a atualização é assim; segundo a documentação, o script baixa as imagens novas, sobe de novo e remove as imagens antigas:

cd nocodb

./update.sh

Se você usou o Docker Compose do exemplo, rode na pasta do arquivo:

docker compose pull && docker compose up -d

Faça o backup da próxima seção antes de atualizar.

Backup do NocoDB

A documentação de backups traz comandos prontos para o banco embutido. Rode na pasta da instalação. O primeiro gera um arquivo SQL com a data no nome:

cd nocodb # pasta da sua instalação

docker compose exec db pg_dump -U nocodb nocodb > backup-$(date +%Y%m%d).sql

Os anexos enviados ficam em um volume do Docker. Para listar o nome do volume e compactá-lo:

docker volume ls | grep _nocodb_data # exemplo: nocodb_nocodb_data

docker run --rm \

-v nocodb_nocodb_data:/data:ro \

-v "$(pwd)":/backup \

alpine tar -czf /backup/attachments-$(date +%Y%m%d).tar.gz -C /data .

Para um backup diário às 3h da manhã, a documentação mostra uma linha de cron em /etc/cron.d/nocodb-backup:

0 3 * * * root cd /opt/nocodb && docker compose exec -T db pg_dump -U nocodb nocodb | gzip > /backups/nocodb-$(date +\%Y\%m\%d).sql.gz

Para restaurar, pare antes o nocodb e o worker, aplique o arquivo e volte com os dois serviços:

docker compose stop nocodb worker

cat backup-20260509.sql | docker compose exec -T db psql -U nocodb nocodb

docker compose start nocodb worker

A documentação deixa um aviso importante: um volume no mesmo servidor não é backup. Copie os dumps e os arquivos de anexos para fora da VPS.

E o SQLite?

O README mostra um docker run com SQLite, sem um banco separado. Use somente como teste rápido para conhecer a ferramenta. Para dados de verdade, fique com o PostgreSQL dos passos acima.

Checklist depois de instalar

  • Criei a minha conta de super admin.
  • O NC_SITE_URL aponta para o endereço com https.
  • Fixei uma versão da imagem em vez de usar latest.
  • Fiz um backup do banco e dos anexos e guardei fora da VPS.
  • Usei o PostgreSQL, não o SQLite, para dados de verdade.
  • Testei a restauração de um backup.

Vale ter o seu banco de dados no seu servidor

Rodar o NocoDB você mesmo mantém as tabelas sob seu controle e sob as regras da licença de uso próprio. Se procura um banco de dados na nuvem, existe o 11SQL, da Eleven Host. Confira na loja o que cada plano inclui.

Quer conhecer a VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS

Perguntas frequentes

O NocoDB é open source?

O README do projeto informa a Sustainable Use License, que limita o uso aos fins internos de negócio ou ao uso pessoal e sem fins comerciais. Em caso de dúvida sobre uso comercial, consulte um profissional.

Qual porta o NocoDB usa?

A 8080 nos exemplos da documentação. Com o instalador e um domínio real, o acesso é pelas portas 80 e 443.

Como fica o primeiro usuário?

Segundo a documentação, o primeiro cadastro vira super admin. Crie a sua conta logo depois de subir.

Preciso de PostgreSQL?

A instalação atual da documentação usa PostgreSQL e Redis. O SQLite aparece só no README, e serve como teste rápido.

Como sei se o NocoDB está respondendo?

A documentação indica o endereço /api/v1/health do NocoDB, que responde a uma requisição GET.

Esta resposta lhe foi útil?

Artigos Relacionados