Base de Conhecimento

ERPNext na VPS: como instalar o ERP da sua empresa

  • erpnext, erp, vps, docker, frappe
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: ERPNext na VPS: como instalar o ERP da sua empresa

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.json para 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.yaml adiciona o serviço do MariaDB. Defina a variável DB_PASSWORD, ou a senha padrão será usada.
  • compose.redis.yaml adiciona o Redis para cache e para a fila de tarefas em segundo plano.
  • compose.https.yaml usa o Traefik como proxy reverso HTTPS na porta 443, com redirecionamento automático de HTTP para HTTPS. As variáveis SITES_RULE e LETSENCRYPT_EMAIL sã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.

Esta resposta lhe foi útil?

Artigos Relacionados