ERPNext na VPS: como instalar o ERP da sua empresa
ERPNext na VPS: entenda a licença, confirme a solução fiscal antes de escolher e conheça os caminhos de produção, o backup e a atualização em Docker.
Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: ERPNext na VPS: como instalar o ERP da sua empresa Arte: Eleven Host
Instalar o ERPNext na VPS é rodar o ERP no seu próprio servidor, com você cuidando da instalação, do backup e das atualizações. Veja o que ele é, a pergunta decisiva sobre nota fiscal no Brasil e os caminhos de instalação para produção.
O que é o ERPNext e qual é a licença
O ERPNext é um sistema de gestão empresarial (ERP) de código aberto. O README do repositório o apresenta como um ERP para ajudar a administrar o negócio. O código fica na organização Frappe no GitHub.
A página do repositório lista a licença GPL-3.0. Os arquivos de contêiner (frappe_docker) têm licença própria, a MIT. A página comercial do projeto diz que o software pode ser usado, modificado ou revendido. Licença sem custo, porém, não quer dizer instalação sem custo: o servidor, o tempo de instalação e a manutenção ficam por sua conta, e recomendamos somar tudo isso antes de decidir. As condições da GPL-3.0 para distribuir o software são assunto para um advogado, se você pretende revendê-lo.
Em 06/11/2026, a página de versões do repositório marca a v16.54.0 como a mais recente, de 06 de novembro. A linha 15 segue recebendo versões, e a v15.124.5 é de 04 de novembro. O arquivo example.env do frappe_docker aponta para a v16.54.0. Não encontramos informação sobre por quanto tempo cada linha recebe suporte, então não dá para prometer um prazo.
Para entender o que você está contratando quando escolhe um servidor próprio, o guia de servidor VPS para iniciantes explica o que é uma VPS e como escolher.
Nota fiscal no Brasil: confirme antes de escolher
Quem precisa emitir nota fiscal deve confirmar a solução fiscal antes de escolher o ERP, e não depois de instalar.
A pasta de localizações por país do repositório (erpnext/regional) mostra Austrália, Itália, África do Sul, Turquia, Emirados Árabes Unidos e Estados Unidos. Em 06/11/2026, o Brasil não consta nessa listagem, que pode estar incompleta. Não encontramos confirmação de que o ERPNext emita NF-e, trate SPED ou calcule impostos brasileiros de fábrica.
Há discussões da comunidade no fórum do Frappe, que não é documentação oficial. Em dezembro de 2025, um usuário escreveu que falta uma localização fiscal robusta. Em fevereiro de 2026, um usuário disse que ele e a equipe do Frappe trabalhavam numa solução e buscavam testadores. Em junho de 2026, outro relatou que os dados de NCM não estavam instalados na v16 padrão. Nas mensagens que encontramos, nenhuma confirma uma entrega.
Na prática, a pergunta para o seu contador ou para o fornecedor da solução é direta: qual módulo ou serviço cuida da nota fiscal, e em qual versão do ERPNext ele funciona? Se a resposta ainda não existe, vale olhar outros sistemas que também podem ser instalados num servidor próprio, como o Dolibarr, ERP e CRM da empresa ou o Invoice Ninja, para faturas e orçamentos. Não afirmamos que eles resolvem a nota fiscal: a mesma pergunta vale para cada sistema.
Sobre o idioma, o repositório tem arquivos de tradução pt_BR.po e pt.po, e a comunidade colabora nas traduções pelo Crowdin. Não encontramos informação sobre o quanto está traduzido.
Requisitos: o que o projeto informa e o que não informa
Não encontramos um mínimo de memória, processador ou disco nos guias de instalação do projeto. Por isso não indicamos plano nem tamanho de servidor. O que se sabe é que a pilha tem vários serviços, além do MariaDB e do Redis, e que o tamanho adequado deve ser testado por você, com os seus dados e o número de usuários.
O que a documentação do Frappe informa são as dependências para a instalação sem Docker, em 29/10/2026:
- Frappe v16 (e develop): MariaDB 11.8, Python 3.14, NodeJS 24 e Redis ou valkey 6 ou superior.
- Frappe v14 e v15: MariaDB 10.6.6 ou superior, Python 3.10 ou superior, NodeJS 18 ou superior e Redis ou valkey 6.
A mesma documentação diz que só dá suporte oficial ao macOS e às distribuições Debian e Ubuntu, e recomenda Debian 13 ou superior, ou Ubuntu 24.04 ou superior, para evitar problemas com alguns pacotes. Com Docker, os requisitos são Docker, Docker Compose v2 e git.
O que a instalação sobe
A visão geral do frappe_docker descreve os serviços do ERPNext em contêineres:
- configurator: ajusta o
common_site_config.jsonpara o Frappe achar o banco e o Redis; roda a cada subida e encerra. - backend: o servidor de aplicação (Werkzeug).
- frontend: nginx, que serve os arquivos e encaminha as requisições.
- websocket: Node com Socket.IO.
- queue: filas de tarefas com rq.
- scheduler: tarefas agendadas.
O arquivo principal, compose.yaml, não traz banco de dados. O MariaDB e o Redis entram por arquivos de override, o que explica os comandos da seção seguinte.
Os caminhos para produção
O guia de escolha do método de instalação do frappe_docker marca como prontos para produção dois caminhos: o script de instalação automática (Easy Install) e a implantação manual com compose.yml mais overrides, descrita como o método canônico de produção. O pwd.yml e os Devcontainers do VS Code não são para produção.
Caminho A: Easy Install
O README do bench traz estes comandos:
wget https://raw.githubusercontent.com/frappe/bench/develop/easy-install.py
python3 easy-install.py deploy --email=user@domain.tld --sitename=subdomain.domain.tld --app=erpnext
O script instala o Docker, baixa os contêineres e prepara o Bench com uma instância padrão do ERPNext. A opção --version escolhe a versão a instalar e, por padrão, usa a última estável. A opção --email recebe o e-mail para o certificado SSL, e o script recusa endereços com example.com. O README diz ainda que o script gera as senhas do root do MySQL e do Administrator e as salva em $HOME/passwords.txt: guarde esse arquivo com cuidado.
Caminho B: Compose com overrides
Neste caminho, você copia o arquivo de exemplo, define as variáveis e gera o arquivo final do Compose. Antes, rode cp example.env .env, defina LETSENCRYPT_EMAIL e SITES_RULE e deixe o DNS do domínio apontando para o servidor. O Exemplo 3 da documentação de setup usa estes comandos:
# Generate YAML
docker compose -f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/docker-compose.yml
# Start containers
docker compose --project-name <project-name> -f ~/gitops/docker-compose.yml up -d
Cada override tem uma função, segundo a documentação do projeto:
compose.mariadb.yamladiciona o serviço do MariaDB. Defina a variávelDB_PASSWORD, ou a senha padrão será usada.compose.redis.yamladiciona o Redis para cache e para a fila de tarefas em segundo plano.compose.https.yamlusa o Traefik como proxy reverso HTTPS na porta 443, com redirecionamento automático de HTTP para HTTPS. As variáveisSITES_RULEeLETSENCRYPT_EMAILsão obrigatórias.
O pwd.yml é só demonstração
O README do ERPNext descreve o pwd.yml como uma configuração para avaliação rápida e avisa que se deve esperar jogar o ambiente fora depois.
Um servidor virtual separado entra nos planos da sua empresa? Confira na loja o que cada plano inclui. Ver as VPS
Criar o site
Com os contêineres no ar, o site do ERPNext é criado dentro do serviço backend. O exemplo de servidor único da documentação do frappe_docker usa o comando abaixo:
docker compose --project-name erpnext-one exec backend \
bench new-site --mariadb-user-host-login-scope=% --db-root-password changeit --install-app erpnext --admin-password changeit one.example.com
O valor changeit é um marcador da documentação: troque-o. Em --db-root-password, a página de operações do projeto mostra o marcador <db-password>: informe a senha do banco que você definiu. O domínio one.example.com também é exemplo.
No caminho B, a senha do administrador é a que você passou em --admin-password. Na demonstração pwd.yml, o acesso é pela porta 8080, com o usuário Administrator e a senha admin, que não devem existir num servidor com dados reais.
Senhas que precisam mudar
O arquivo example.env traz DB_PASSWORD=123. Se a variável não for definida, vale a senha padrão do override do MariaDB. Recomendamos definir uma senha própria, longa e única, antes da primeira subida, e trocar também os changeit dos exemplos.
Existe também a variante compose.mariadb-secrets.yaml, que adiciona o MariaDB com a senha vinda de um arquivo de segredo, e não de uma variável de ambiente.
Backup: o agendamento do exemplo
O ERPNext tem o comando bench backup. A opção --with-files inclui os arquivos privados e públicos, e a --compress comprime esses arquivos. Os dumps ficam em ./sites/{site}/private/backups.
O exemplo da documentação para agendar o backup em Docker é um cron que o administrador cria. Ele executa o backup de todos os sites a cada 6 horas. No crontab, vai em uma linha só:
0 */6 * * * docker compose -p erpnext -f /path/to/compose.yml exec -T backend bench --site all backup --with-files > /dev/null
Recomendamos copiar os backups para fora do servidor, porque um backup guardado só nele se perde junto com ele.
Restaurar um backup
A sintaxe é bench restore [OPTIONS] SQL_FILE_PATH, com opções como --with-public-files e --with-private-files, entre outras. O comando não restaura apenas os arquivos: não há como fazer isso por ele. A documentação também avisa que downgrades não são suportados para sites do Frappe. A opção --force ignora o aviso, mas é marcada como não recomendada.
Não encontramos, na documentação do projeto, o passo a passo de restauração em Docker. Recomendamos testar a restauração num ambiente separado antes de precisar dela, e não descobrir o procedimento no dia em que os dados se perderam.
Atualizar em Docker
Em Docker, o caminho documentado é o das imagens novas, e não o bench update, que é do Bench sem Docker. Não misture os dois. O roteiro do projeto é: editar ERPNEXT_VERSION e FRAPPE_VERSION no .env, gerar de novo o arquivo do Compose, baixar as imagens, parar os contêineres e subir de novo. Na geração do arquivo, a linha # ... your other overrides é um lembrete de que cada -f dos seus overrides entra ali: troque-a por eles.
nano .env
docker compose --env-file .env \
-f compose.yaml \
# ... your other overrides
config > ~/gitops/docker-compose.yml
docker compose --project-name <project-name> -f ~/gitops/docker-compose.yml pull
docker compose --project-name <project-name> -f ~/gitops/docker-compose.yml down
docker compose --project-name <project-name> -f ~/gitops/docker-compose.yml up -d
Depois, a documentação manda migrar os sites. A página de operações usa docker-compose com hífen; ajuste ao comando e ao nome de projeto que você usa:
docker-compose exec backend bench --site <site-name> migrate
Sem Docker, o bench update, sem opções, faz o backup, baixa o código, instala os requisitos, compila, roda os patches e reinicia o Bench. Não encontramos guia oficial para saltar de uma versão principal para outra, como da v15 para a v16. Recomendamos fazer o backup completo antes e testar a atualização numa cópia.
Antes de escolher o servidor
Com o backup, a restauração e as senhas resolvidos, resta a escolha do servidor.
Dá para comparar os planos de servidor virtual antes de decidir? Confira na loja o que cada plano inclui. Comparar as VPS
Perguntas frequentes
O ERPNext emite nota fiscal brasileira?
Não podemos afirmar isso. Não encontramos confirmação de que ele emita NF-e, e o Brasil não consta na listagem de localizações do repositório em 06/11/2026, que pode estar incompleta. Confirme a solução fiscal antes de escolher.
Qual o tamanho de servidor necessário?
Não encontramos um mínimo de memória, processador ou disco nos guias do projeto. Teste com os seus dados antes de colocar a equipe para usar.
Posso usar o pwd.yml em produção?
Não. Ele é uma configuração de demonstração, pensada para ser descartada. Para produção, o projeto indica o Easy Install ou o Compose com overrides.
O backup é automático?
O exemplo da documentação em Docker é um cron criado pelo administrador, que roda o bench backup a cada 6 horas. Confirme no seu ambiente o que está agendado.