Base de Conhecimento

Dolibarr na VPS: ERP e CRM da empresa no seu servidor

  • dolibarr, erp, crm, docker compose, autohospedagem, vps
  • Usuários acharam útil: 0

Aprenda a instalar o Dolibarr ERP e CRM da série 24 na sua VPS com Docker Compose: requisitos, senhas padrão a trocar, checklist de produção, backup e atualização.

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

Arte da Eleven Host: janela de terminal com o título: Dolibarr na VPS: ERP e CRM da empresa no seu servidor

Capa da Redação Eleven Host para o guia: Dolibarr na VPS: ERP e CRM da empresa no seu servidor Arte: Eleven Host

Dolibarr na VPS: o Dolibarr ERP & CRM é um pacote de software moderno que ajuda a gerenciar as atividades da sua organização. Veja os requisitos, a instalação com Docker Compose, as senhas que você precisa trocar, o HTTPS, o backup e a atualização.

Este passo a passo trata da série 24; o site do projeto informa a 24.0.2 como a última versão. Se você ainda está conhecendo o assunto, o guia O que é servidor VPS explica o básico do servidor onde o Dolibarr vai ficar.

O que é o Dolibarr e para quem serve

O README descreve o Dolibarr ERP & CRM como um pacote de software moderno que ajuda a gerenciar as atividades da organização, como contatos, orçamentos, faturas, pedidos, estoques, agenda, recursos humanos, gestão de documentos e produção. O projeto diz ter sido pensado para empresas pequenas, médias ou grandes, fundações e profissionais autônomos.

No site do projeto, os módulos aparecem em grupos:

  • CRM e vendas: prospects e clientes, oportunidades, propostas, pedidos de venda e central de chamados;
  • Produtos e estoque: produtos e serviços, estoques, compras, expedições e produção;
  • Finanças: faturamento e pagamentos, conciliação bancária e contabilidade de partidas dobradas;
  • RH e produtividade: funcionários, relatórios de despesas, projetos e tarefas e agenda;
  • Integração: API, importação e exportação e o Module Builder para desenvolvedores.

O README lista o que o Dolibarr ainda não faz: dependências entre tarefas dos projetos e webmail embutido, embora seja possível enviar e-mails a contatos pelo próprio Dolibarr, como ofertas e faturas.

A licença do Dolibarr é a GNU General Public License, versão 3 ou posterior (GPL-3+), segundo o README do projeto.

Requisitos da série 24

A tabela de releases da wiki do Dolibarr informa, para a série 24, o PHP 7.2 como mínimo e o PHP 8.5 como máximo. Para o banco de dados, ela aceita MySQL 5.7.7 ou superior, MariaDB 10.3 ou superior, ou PostgreSQL 9.1 ou superior.

A página de pré-requisitos da wiki traz outros detalhes:

  • as sessões de usuário do PHP precisam estar ativas, e o memory_limit do PHP precisa permitir 128 MB;
  • os arquivos do programa usam cerca de 150 MB em disco, e os arquivos do banco, cerca de 35 MB; módulos extras, arquivos enviados e PDFs gerados ocupam mais espaço.

O seu ERP vai funcionar em ambiente próprio ou compartilhado? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Instalação com Docker Compose

O projeto mantém uma imagem Docker do Dolibarr, cujo repositório fica na organização Dolibarr do GitHub. O README dessa imagem diz que ela é baseada no repositório oficial do PHP e no repositório oficial do Dolibarr. A imagem não traz banco de dados, e por isso o Compose sobe o MariaDB ao lado.

Crie antes, no servidor, as pastas que guardam os dados fora dos contêineres. O README indica estas três:

sudo mkdir -p /home/dolibarr_mariadb /home/dolibarr_documents /home/dolibarr_custom

Depois, salve na mesma pasta o arquivo docker-compose.yml do README da imagem. Ele usa a imagem dolibarr/dolibarr:latest, descrita no arquivo como a última versão estável, e também aceita :x.y.z para fixar uma versão. As variáveis do arquivo têm um valor padrão, no formato ${VARIAVEL:-padrao}, e é aí que mora o perigo.

Troque as senhas padrão antes de subir

O Compose do README vem com senhas padrão. Quem sobe a imagem sem mudar nada fica com estas quatro:

  • Administrador do Dolibarr: login admin e senha admin (DOLI_ADMIN_LOGIN e DOLI_ADMIN_PASSWORD);
  • Senha do usuário do banco: dolidbpass (MYSQL_PASSWORD e DOLI_DB_PASSWORD);
  • Senha do root do MariaDB: root (MYSQL_ROOT_PASSWORD);
  • Chave do cron: mycronsecurekey (DOLI_CRON_KEY).

Aviso: troque as quatro senhas

Essas senhas padrão são públicas, porque estão no README da imagem. Recomendamos trocar todas as quatro antes do primeiro up, com valores longos e diferentes entre si. A MYSQL_PASSWORD e a DOLI_DB_PASSWORD precisam ter o mesmo valor, para o Dolibarr conseguir entrar no banco.

Como o Compose lê as variáveis do ambiente, o jeito mais simples é criar um arquivo .env na mesma pasta, com seus valores. O exemplo abaixo usa um domínio fictício e senhas de mentira, que você deve substituir:

MYSQL_ROOT_PASSWORD=troque-esta-senha-do-root

MYSQL_PASSWORD=troque-esta-senha-do-banco

DOLI_DB_PASSWORD=troque-esta-senha-do-banco

DOLI_ADMIN_LOGIN=seu-usuario-admin

DOLI_ADMIN_PASSWORD=troque-esta-senha-do-admin

DOLI_CRON_KEY=troque-esta-chave-do-cron

DOLI_URL_ROOT=https://dolibarr.exemplo.com.br

DOLI_COMPANY_NAME=Minha Empresa

PHP_INI_DATE_TIMEZONE=America/Sao_Paulo

A DOLI_URL_ROOT é o endereço pelo qual o Dolibarr será acessado. O valor padrão do Compose é http://0.0.0.0, então ajuste para o seu domínio. A variável PHP_INI_DATE_TIMEZONE tem o padrão UTC, e o America/Sao_Paulo acima é um exemplo para o horário do Brasil.

Subir e acompanhar

Com o .env pronto, suba os contêineres e veja os registros. O README usa o docker-compose; nas versões novas do Docker, o comando é docker compose:

sudo docker compose up -d

sudo docker compose ps

sudo docker compose logs

A variável DOLI_INSTALL_AUTO vale 1 por padrão, e o README explica que a instalação é feita no primeiro boot do Docker. O administrador é criado com o login e a senha que você definiu no .env. Se a porta 80 já estiver ocupada, o README manda trocar o mapeamento para xx:80.

Instalação pelo assistente web

Se você instala o Dolibarr sem Docker, pelo pacote genérico, o README dá três passos: criar um arquivo htdocs/conf/conf.php vazio, com permissão de escrita para o usuário do servidor web; abrir a página install/ no navegador; e seguir as instruções do instalador. A permissão de escrita deve ser retirada quando a instalação terminar.

O install.lock e o conf.php

Ao fim da instalação, a wiki manda criar o arquivo install.lock na pasta de documentos do Dolibarr, de um jeito que só o root possa apagar. O comando da wiki, com o caminho de exemplo dela, é:

touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;

Segundo a wiki, esse arquivo impede que alguém reinicie a instalação. A wiki também manda deixar o conf.php somente para leitura depois da instalação; no Linux, recomendamos chmod 400 ou 440.

Checklist de produção do projeto

O arquivo SECURITY.md do projeto diz que a instalação precisa ser feita corretamente para uso em produção. Isso inclui:

  • criar o install.lock no último passo da instalação;
  • definir $dolibarr_main_prod como 1 no conf.php;
  • definir $dolibarr_main_force_https com um valor diferente de 0;
  • apontar a raiz do servidor web para a pasta htdocs, com a pasta de documentos fora dessa raiz;
  • deixar em modo de escrita somente a pasta de documentos, com a pasta htdocs somente para leitura;
  • usar regras de Fail2ban para limitar tentativas na página de login, na de senha esquecida e nas chamadas de API.

A página de configuração de segurança da wiki diz que é muito recomendado ativar a criptografia das senhas guardadas no banco.

HTTPS e proxy na frente

A imagem Docker escuta na porta 80, sem HTTPS, e o Compose do README publica essa porta com "80:80". Recomendamos publicar o Dolibarr só no próprio servidor, trocando a linha da porta no Compose por "127.0.0.1:8080:80" (a porta 8080 é um exemplo), e colocar um proxy com HTTPS na frente. O guia Nginx Proxy Manager: vários sites numa VPS só mostra uma forma de fazer isso, e o Caddy na VPS: servidor web com HTTPS automático mostra outra.

A wiki do Dolibarr chama de método recomendado, para o $dolibarr_main_force_https, informar o endereço do seu domínio, como https://meudominio. Mantenha também a DOLI_URL_ROOT com https://.

Para comparar, veja o Odoo na VPS: como instalar o ERP com Docker, outro ERP que roda no mesmo tipo de servidor.

Backup do Dolibarr

A wiki do Dolibarr divide o backup em três partes:

  • Banco de dados: guarda tudo o que você cadastrou nas telas do Dolibarr;
  • Documentos: os arquivos ligados à sua instância, e a pasta inteira deve ser copiada;
  • Configuração: o arquivo conf.php.

O Dolibarr tem uma ferramenta embutida no caminho Home, System tools, Backups. O arquivo de dump gerado por ela fica dentro da pasta de documentos. A wiki também cita o mysqldump e avisa para evitar o phpMyAdmin ao salvar o banco, porque a exportação padrão pode não restaurar bem.

Guarde o conf.php junto com a cópia. Segundo a wiki, sem a chave dolibarr_main_dolcrypt_key, os dados sensíveis, como tokens e dados bancários, continuam ofuscados e você não os lê.

No Docker com o Compose acima, recomendamos copiar as pastas /home/dolibarr_documents e /home/dolibarr_custom, fazer um dump do MariaDB e levar tudo para fora da VPS.

Como atualizar

O README diz que o Dolibarr aceita atualizar a partir de qualquer versão posterior à 2.8 sem quebras. O primeiro passo é um backup do banco, da pasta de documentos, da pasta custom (se houver módulos externos) e do conf.php. Depois, confira se a sua versão do PHP é suportada pela nova versão.

Com o Docker, o README da imagem avisa que só os dados guardados nas pastas persistentes sobrevivem à atualização. O procedimento é este:

  • remova o arquivo install.lock que fica no volume /var/www/documents, dentro do contêiner;
  • baixe as imagens novas com sudo docker compose pull;
  • reinicie com sudo docker compose up -d e acompanhe com sudo docker compose logs;
  • confirme que a DOLI_INSTALL_AUTO vale 1, para o Dolibarr migrar o banco.

Se você instalou pelo pacote, sobrescreva os arquivos antigos com os da nova versão e abra o sistema no navegador, que segue para a página install/. Se existir um install.lock, o Dolibarr pede que você o remova à mão.

Um aviso da wiki, sobre a atualização pela linha de comando: ao pular de uma versão maior direto para outra, como da 22 para a 24, as migrações de dados da versão intermediária são ignoradas, sem nenhum erro.

O Dolibarr em português do Brasil

O repositório do Dolibarr no GitHub traz a pasta de tradução pt_BR entre os idiomas. Confira a cobertura da tradução numa instalação de teste antes de levar os dados da empresa.

Resumo da instalação

  • Crie as pastas /home/dolibarr_* e salve o Compose do README.
  • Troque as quatro senhas padrão no .env antes do primeiro up.
  • Ajuste a DOLI_URL_ROOT para o seu domínio com https://.
  • Publique a porta só no servidor e ponha um proxy com HTTPS na frente.
  • Confira o checklist do SECURITY.md e o install.lock.
  • Agende o backup do banco, dos documentos e do conf.php.

Antes de escolher o servidor

Vale conhecer as opções de VPS para decidir onde o ERP vai ficar.

Ainda está decidindo o servidor da sua empresa? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

Qual é a licença do Dolibarr?

Segundo o README, o Dolibarr é distribuído sob a GNU General Public License, versão 3 ou posterior (GPL-3+).

Quais bancos de dados o Dolibarr aceita?

Pela tabela de releases da wiki, a série 24 aceita MySQL 5.7.7 ou superior, MariaDB 10.3 ou superior e PostgreSQL 9.1 ou superior.

Preciso trocar as senhas da imagem Docker?

Sim. O Compose do README usa admin e admin para o administrador, dolidbpass para o banco, root para o root do MariaDB e mycronsecurekey para o cron. Recomendamos trocar as quatro antes de subir.

Esta resposta lhe foi útil?

Artigos Relacionados