NocoDB na VPS: como instalar com Docker
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

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 noNC_DBdonocodb, noNC_DBdoworkere emPOSTGRES_PASSWORDdo serviçodb. - 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_URLpelo endereço final com https, por exemplohttps://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. Comlocalhost, 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_SECRETsó meu. - Troquei o
NC_SITE_URLpelo endereço com https. - Publiquei a porta como
127.0.0.1:8080:8080se 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_URLaponta 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.