Dolibarr na VPS: ERP e CRM da empresa no seu servidor
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

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_limitdo 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
admine senhaadmin(DOLI_ADMIN_LOGINeDOLI_ADMIN_PASSWORD); - Senha do usuário do banco:
dolidbpass(MYSQL_PASSWORDeDOLI_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.lockno último passo da instalação; - definir
$dolibarr_main_prodcomo 1 noconf.php; - definir
$dolibarr_main_force_httpscom 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
htdocssomente 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.lockque 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 -de acompanhe comsudo docker compose logs; - confirme que a
DOLI_INSTALL_AUTOvale1, 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
.envantes do primeiroup. - Ajuste a
DOLI_URL_ROOTpara o seu domínio comhttps://. - 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.