O que é Dolibarr e por que escolher um ERP Open Source Self-Hosted?
No cenário atual de transformação digital, pequenas e médias empresas (PMEs) frequentemente buscam soluções de gestão robustas sem os custos elevados de licenciamento de software proprietário. É aqui que entra o conceito de ERP open source, uma alternativa poderosa para quem deseja controle total sobre seus dados financeiros, comerciais e logísticos. Entre as diversas opções disponíveis, o Dolibarr ERP & CRM destaca-se pela sua modularidade, facilidade de uso e comunidade ativa.
Diferente de soluções SaaS (Software as a Service) que mantêm seus dados em servidores terceirizados, optar por uma instalação self-hosted em sua própria infraestrutura garante soberania digital. Ao utilizar uma VPS Linux, você assume o controle completo da segurança, backups e performance da aplicação. Este tutorial guiará você através do processo de instalação completa do Dolibarr em um ambiente Ubuntu Server, oferecendo uma configuração estável e segura para gerenciar sua empresa.
Muitos usuários que migraram de plataformas como Odoo ou SuiteCRM encontram no Dolibarr a simplicidade necessária. Enquanto o Odoo pode ser complexo e custoso ao adicionar módulos, e o SuiteCRM foca quase exclusivamente na área comercial, o Dolibarr oferece uma suite completa que integra contabilidade, estoque, faturamento e CRM em uma única interface coesa.
Pré-requisitos para a Instalação
Antes de iniciarmos o processo de dolibarr instalação ubuntu, é fundamental preparar o ambiente. Recomendamos utilizar uma VPS com pelo menos 2GB de RAM e 40GB de disco SSD para garantir boa performance, especialmente se você planeja integrar módulos pesados como gestão financeira completa ou controle de estoque avançado.
O sistema operacional alvo será o Ubuntu Server (versões LTS recomendadas, como 22.04 ou 24.04). A instalação será realizada via linha de comando, utilizando o Apache como servidor web e MariaDB/MySQL para o banco de dados. Também configuraremos o PHP com as extensões necessárias para o funcionamento correto da aplicação.
Etapa 1: Atualização do Sistema e Instalação das Dependências
O primeiro passo em qualquer tutorial instalação de servidor Linux é garantir que o sistema esteja atualizado. Isso previne conflitos de pacotes e garante que você tenha as últimas correções de segurança.
sudo apt update
sudo apt upgrade -y
Em seguida, instalaremos o grupo de ferramentas necessário para baixar e compilar dependências, além do servidor web Apache.
sudo apt install apache2 libapache2-mod-php php php-mysql php-curl php-gd php-intl php-mbstring php-xml php-zip curl unzip -y
Se você preferir utilizar o MariaDB (recomendado por sua leveza e compatibilidade) em vez do MySQL padrão, instale-o com:
sudo apt install mariadb-server mariadb-client -y
Caso prefira manter o MySQL tradicional:
sudo apt install mysql-server mysql-client -y
Etapa 2: Configuração do Banco de Dados
Agora, devemos configurar a segurança do banco de dados e criar o usuário e o banco de dados específicos para o Dolibarr. Isso isola os dados da aplicação e melhora a segurança geral do servidor.
Inicie o script de segurança do MySQL/MariaDB:
sudo mysql_secure_installation
Siga as instruções na tela: defina uma senha forte para o root, remova usuários anônimos, desative o login remoto do root e remova o banco de dados de teste. Em seguida, acesse o prompt do MySQL:
sudo mysql -u root -p
Dentro do prompt do SQL, execute os seguintes comandos para criar o banco de dados e o usuário dedicado. Substitua senha_forte_aqui por uma senha complexa gerada por você.
CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'dolibarr_user'@'localhost' IDENTIFIED BY 'senha_forte_aqui';
GRANT ALL PRIVILEGES ON dolibarr_db.* TO 'dolibarr_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Com o banco de dados preparado, estamos prontos para baixar e configurar o código fonte do Dolibarr.
Etapa 3: Download e Extração do Dolibarr
Acesse o site oficial do Dolibarr ou utilize o repositório estável mais recente. Para este tutorial, utilizaremos a versão estável mais recente disponível via wget. Verifique sempre a página de downloads para obter o link exato da última versão.
cd /tmp
wget https://github.com/Dolibarr/dolibarr/releases/download/vXX.X.X/dolibarr-XX.X.tgz
Nota: Substitua vXX.X.X pela versão desejada. Após baixar, mova os arquivos para o diretório raiz do documento Apache.
sudo tar -xvzf dolibarr-*.tgz -C /var/www/html/
sudo mv /var/www/html/dolibarr-* /var/www/html/dolibarr
sudo chown -R www-data:www-data /var/www/html/dolibarr
sudo chmod -R 755 /var/www/html/dolibarr
A estrutura de diretórios agora está correta. O usuário www-data (que é o usuário do processo Apache) precisa ter permissão de leitura e execução, mas a gravação ocorrerá principalmente na pasta htdocs/theme e áreas temporárias durante a instalação.
Etapa 4: Configuração do Apache
Precisamos configurar o Apache para servir o Dolibarr corretamente. Vamos criar um arquivo de virtual host.
sudo nano /etc/apache2/sites-available/dolibarr.conf
Cole a seguinte configuração, ajustando o ServerName para o seu domínio ou IP público:
<VirtualHost *:80>
ServerAdmin [email protected]
ServerName seudominio.com
DocumentRoot /var/www/html/dolibarr/htdocs
<Directory /var/www/html/dolibarr/htdocs>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>>
ErrorLog ${APACHE_LOG_DIR}/dolibarr_error.log
CustomLog ${APACHE_LOG_DIR}/dolibarr_access.log combined
</VirtualHost>
Habilite o módulo rewrite (essencial para URLs amigáveis) e o novo site:
sudo a2enmod rewrite
sudo a2ensite dolibarr.conf
sudo systemctl restart apache2
Etapa 5: Configuração do PHP
O Dolibarr possui requisitos específicos para o PHP. Vamos garantir que as configurações padrão suportem uploads de arquivos e limites de memória adequados.
sudo nano /etc/php/8.1/apache2/php.ini
Procure e altere as seguintes linhas (ajuste a versão do PHP conforme instalado, ex: 8.0, 8.2):
memory_limit = 256Mupload_max_filesize = 10Mpost_max_size = 10Mmax_execution_time = 300
Reinicie o Apache para aplicar as mudanças:
sudo systemctl restart apache2
Etapa 6: Instalação via Web Interface
Agora, a parte mais amigável. Abra seu navegador e acesse http://seu-ip-ou-dominio/install/.
Você verá a tela de boas-vindas da instalação do Dolibarr. Siga os passos:
- Idioma: Selecione "Português (Brasil)" se disponível, ou "English" e configure depois.
- Tipo de Instalação: Escolha
Normal. Evite a opção "Demo". - Banco de Dados:
- Tipo: MySQL/MariaDB
- Host: localhost
- Usuário: dolibarr_user
- Senha: a senha criada na Etapa 2
- Nome do Banco: dolibarr_db
Clique em "Testar conexão". Se tudo estiver correto, avance. O sistema criará as tabelas e inserirá os dados iniciais.
- Login de Administração: Defina um login e senha fortes para o usuário administrador (geralmente
admin). Esta é a sua conta mestre.
Ao finalizar, o Dolibarr solicitará que você renomeie ou exclua a pasta de instalação por motivos de segurança. Execute o comando sugerido na tela:
sudo rm -rf /var/www/html/dolibarr/install
Etapa 7: Segurança e Pós-Instalação
Com o Dolibarr rodando, é crucial proteger a instalação. Vamos instalar o Let's Encrypt para garantir conexão HTTPS, essencial para proteger dados financeiros e de clientes.
sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d seudominio.com
Siga as instruções do Certbot para gerar o certificado SSL. Isso redirecionará automaticamente todo o tráfego HTTP para HTTPS.
Configurando Backups Automáticos
Como responsável pela infraestrutura self-hosted, você deve garantir backups regulares. Crie um script simples para backup do banco de dados e dos arquivos:
sudo nano /opt/backup-dolibarr.sh
Conteúdo do script:
#!/bin/bash
DATE=$(date +%Y%m%d)
BACKUP_DIR="/var/backups/dolibarr"
mkdir -p $BACKUP_DIR
# Backup do Banco de Dados
mysqldump -u dolibarr_user -p'senha_forte_aqui' dolibarr_db > $BACKUP_DIR/db_$DATE.sql
# Backup dos Arquivos
tar -czf $BACKUP_DIR/files_$DATE.tar.gz /var/www/html/dolibarr/htdocs
# Remover backups antigos (mantém últimos 7 dias)
find $BACKUP_DIR -type f -mtime +7 -delete
Torne o script executável e agende via Cron:
sudo chmod +x /opt/backup-dolibarr.sh
sudo crontab -e
Adicione a linha para rodar diariamente às 3 da manhã:
0 3 * * * /opt/backup-dolibarr.sh
Conclusão: Sua Solução de Gestão Empresarial Pronta
Você concluiu com sucesso a dolibarr instalação ubuntu. Agora possui um sistema de gestão empresarial completo, seguro e sob seu controle. O Dolibarr permite começar com módulos básicos (contas a pagar/receber, catálogo de produtos) e expandir conforme a necessidade da empresa, adicionando módulos de RH, projetos ou integração com gateways de pagamento.
Diferente de uma odoo alternativa que pode exigir licenças caras para funcionalidades essenciais, o Dolibarr mantém quase toda sua suite disponível no código aberto. Além disso, por ser self-hosted, você não paga taxas por usuário ou transação.
Para manter o sistema saudável, configure monitoramento de recursos na sua VPS Linux e mantenha as atualizações do Ubuntu e do Dolibarr em dia. A comunidade Dolibarr é ativa e oferece documentação rica para resolver dúvidas específicas sobre personalização e integração.
Este tutorial de tutorial instalação serviu como base para implantar uma ferramenta robusta de gestão empresarial. Lembre-se: a segurança começa com boas práticas de administração do servidor. Proteja suas portas SSH, use senhas fortes e mantenha seus backups testados.