Instalação Dolibarr no Ubuntu: ERP Open Source Simples

10 min de leitura Tutoriais Linux
Instalação Dolibarr no Ubuntu: ERP Open Source Simples

O que é o Dolibarr e por que escolher uma solução Self-Hosted?

No cenário atual de transformação digital, pequenas e médias empresas (PMEs) frequentemente enfrentam o dilema entre custos elevados de licenças de software proprietário e a complexidade de soluções corporativas massivas. É nesse contexto que o Dolibarr se destaca como uma das melhores opções de ERP open source disponíveis no mercado. Diferente de plataformas SaaS (Software as a Service) que mantêm seus dados em servidores terceiros, optar por uma instalação self-hosted em sua própria infraestrutura oferece controle total sobre a privacidade dos dados, conformidade com leis de proteção (como a LGPD) e personalização ilimitada.

O Dolibarr é um software moderno de gestão empresarial (ERP/CRM) destinado a empresas, fundações ou freelancers. Ele permite gerenciar contatos, pedidos, faturas, estoque, projetos e muito mais. Por ser baseado em tecnologias web padrão (PHP e MySQL/MariaDB), sua instalação em um ambiente VPS Linux, especialmente distribuições Debian-based como o Ubuntu, é relativamente direta, desde que seguidos os passos corretos de configuração de dependências e segurança.

Neste tutorial completo, guiar você pela instalação do Dolibarr em um servidor Ubuntu limpo. Vamos desde a preparação do sistema operacional até a configuração final do banco de dados e acesso à interface web.

Pré-requisitos para a Instalação

Antes de iniciarmos o processo técnico, é fundamental garantir que seu ambiente esteja preparado. Para uma instalação estável e performática do Dolibarr em produção, recomendamos os seguintes requisitos mínimos:

  • Servidor VPS Linux: Uma instância Ubuntu Server 20.04 ou 22.04 LTS.
  • Recurso de Hardware: Mínimo de 1 vCPU e 2GB de RAM (4GB é recomendado para melhor desempenho com múltiplos usuários).
  • Privilégios de Root: Acesso com usuário root ou um usuário sudoers.
  • Dominio Configurado: Um nome de domínio apontando para o IP do seu servidor (opcional, mas recomendado para produção).

Se você ainda não possui acesso ao terminal, conecte-se ao seu servidor via SSH:

ssh root@seu_ip_do_servidor

Etapa 1: Atualização do Sistema e Instalação das Dependências

O primeiro passo em qualquer administração de servidor Linux é garantir que os pacotes do sistema estejam atualizados. Isso garante correções de segurança e compatibilidade com as versões mais recentes das bibliotecas necessárias.

Execute o comando abaixo para atualizar o índice de pacotes e instalar as atualizações pendentes:

apt update && apt upgrade -y

O Dolibarr é uma aplicação escrita em PHP que requer um servidor web (Apache ou Nginx) e um banco de dados relacional. Além disso, precisa de extensões específicas do PHP para manipulação de imagens, PDFs e comunicação com o banco de dados.

Instale o Apache, o MariaDB (um fork popular e compatível do MySQL), e as extensões essenciais do PHP em um único comando:

apt install apache2 mariadb-server php libapache2-mod-php php-cli php-common php-mysql php-curl php-gd php-intl php-mbstring php-xml php-zip php-bcmath php-json php-xmlrpc php-soap -y

Esta lista de pacotes cobre a maioria das funcionalidades padrão do Dolibarr. Se você planeja usar módulos específicos que exigem SMTP externo ou outras bibliotecas, pode ser necessário instalar pacotes adicionais posteriormente.

Etapa 2: Configuração e Segurança do Banco de Dados

Agora que o banco de dados MariaDB está instalado, precisamos configurá-lo com segurança e criar o banco de dados específico para o Dolibarr. Por padrão, o MariaDB vem sem senha para o usuário root local.

Inicie o script de segurança inicial:

mysql_secure_installation

Siga as instruções na tela: 1. Pressione Enter quando perguntado sobre a senha atual do root (não há nenhuma). 2. Digite y para definir uma senha forte para o root do MySQL/MariaDB. 3. Digite y para remover usuários anônimos. 4. Digite y para desativar o login remoto do root (recomendado para segurança). 5. Digite y para remover o banco de dados de teste. 6. Digite y para recarregar as tabelas de privilégios agora.

Com a segurança básica estabelecida, vamos criar o usuário e o banco de dados para o Dolibarr. Entre no shell do MySQL:

mysql -u root -p

Digite a senha que você definiu anteriormente. Dentro do prompt do MariaDB, execute os seguintes comandos SQL (substitua sua_senha_forte por uma senha complexa):

CREATE DATABASE dolibarr_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'dolibarr_user'@'localhost' IDENTIFIED BY 'sua_senha_forte';
GRANT ALL PRIVILEGES ON dolibarr_db.* TO 'dolibarr_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Agora você tem um banco de dados vazio e isolado, pronto para receber as tabelas do ERP.

Etapa 3: Download e Extração do Dolibarr

Vamos baixar a versão estável mais recente do Dolibarr diretamente dos repositórios oficiais. Utilizaremos o diretório /var/www/html, que é o padrão para servidores Apache.

Crie um diretório temporário e baixe o arquivo tarball:

cd /tmp
wget https://github.com/Dolibarr/dolibarr/releases/download/develop/dolibarr-xx.x.x.tar.gz

Nota: Verifique sempre a página de releases do GitHub para obter o link exato da versão mais recente. O comando acima é um exemplo genérico.

Crie o diretório de instalação e extraia os arquivos:

mkdir -p /var/www/dolibarr
tar -xzf dolibarr-xx.x.x.tar.gz -C /var/www/dolibarr --strip-components=1

O parâmetro --strip-components=1 é importante para garantir que os arquivos sejam extraídos diretamente na raiz do diretório de instalação, evitando subdiretórios extras como dolibarr-xx.x.x/.

Agora, defina as permissões corretas. O usuário do Apache (no Ubuntu, geralmente www-data) precisa ter permissão de leitura e escrita em certas pastas para gerar arquivos PDF, fazer upload de documentos e armazenar sessões.

chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr

Etapa 4: Configuração do Servidor Web (Apache)

O Apache precisa ser configurado para servir o Dolibarr corretamente. Vamos criar um arquivo de virtual host.

Crie o arquivo de configuração:

nano /etc/apache2/sites-available/dolibarr.conf

Cole o seguinte conteúdo (ajuste o ServerName para seu domínio ou use o IP do servidor):

<VirtualHost *:80>
    ServerAdmin admin@seudominio.com
    ServerName seudominio.com
    DocumentRoot /var/www/dolibarr/htdocs

    <Directory /var/www/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

    # Redirecionar para HTTPS se estiver configurado (opcional no início)
    # RewriteEngine On
    # RewriteCond %{HTTPS} off
    # RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
</VirtualHost>

Habilite o módulo de reescrita do Apache (necessário para URLs amigáveis) e seu novo site, desabilitando a configuração padrão:

a2enmod rewrite
a2ensite dolibarr.conf
a2dissite 000-default.conf

Reinicie o serviço Apache para aplicar as mudanças:

systemctl restart apache2

Etapa 5: Configuração do PHP e Segurança Inicial

Antes de acessar a interface web, é crucial ajustar algumas configurações no arquivo php.ini para garantir que o Dolibarr funcione sem erros de memória ou tempo limite.

Edite o arquivo php.ini (o caminho pode variar dependendo da versão do PHP instalada, ex: /etc/php/8.1/apache2/php.ini):

nano /etc/php/$(php -r 'echo php_version();')/apache2/php.ini

Procure e altere as seguintes linhas para valores adequados para um ERP:

memory_limit = 256M
upload_max_filesize = 20M
post_max_size = 20M
max_execution_time = 300
date.timezone = America/Sao_Paulo

Substitua America/Sao_Paulo pelo fuso horário correto do seu servidor. Salve o arquivo e reinicie o Apache novamente:

systemctl restart apache2

Etapa 6: Execução do Instalador Web

Agora que toda a infraestrutura está pronta, podemos finalizar a configuração através da interface web. Abra seu navegador e acesse o endereço do seu servidor:

http://seu_ip_do_servidor

O Dolibarr irá detectar que ainda não foi configurado e redirecionará para a tela de instalação.

  1. Tela de Boas-vindas: Clique em "Install Dolibarr".
  2. Idioma: Selecione Português (Brasil).
  3. Condições de Licença: Aceite os termos da GPL.
  4. Verificação de Compatibilidade: O sistema verificará se o PHP e o servidor atendem aos requisitos. Se houver avisos sobre módulos não instalados, você pode prosseguir, mas é ideal instalar as dependências faltantes via apt.
  5. Banco de Dados:
    • Tipo de servidor: MariaDB/MySQL
    • Endereço do servidor: localhost
    • Nome do banco de dados: dolibarr_db
    • Login: dolibarr_user
    • Senha: sua_senha_forte
  6. Criação do Usuário Admin: Crie o login e senha para o administrador inicial. Anote essas credenciais.
  7. Finalização: Clique em "Avançar" até a conclusão.

A instalação criará todas as tabelas no banco de dados e configurará os arquivos de configuração necessários automaticamente.

Etapa 7: Pós-Instalação e Higiene do Servidor

Após a conclusão da instalação, o Dolibarr geralmente exibe uma mensagem avisando para remover o diretório de instalação ou renomeá-lo por questões de segurança. Embora as versões recentes tenham melhorado isso, é uma boa prática limpar o ambiente.

Renomeie o diretório de instalação original se ele ainda existir (geralmente já foi removido pelo instalador, mas verifique):

mv /var/www/dolibarr/install /var/www/dolibarr/install.bkp

Além disso, para garantir que suas conexões sejam seguras, é altamente recomendável instalar um certificado SSL gratuito usando o Let's Encrypt.

Instale o Certbot:

apt install certbot python3-certbot-apache -y

E execute o comando para obter e configurar o certificado automaticamente:

certbot --apache -d seudominio.com

Siga as instruções na tela para ativar o redirecionamento automático de HTTP para HTTPS. Isso criptografará toda a comunicação entre o navegador dos seus usuários e o servidor.

Conclusão: Gerenciando seu ERP Open Source

Você concluiu com sucesso a instalação do Dolibarr em um servidor Ubuntu. Agora você possui uma ferramenta poderosa de gestão empresarial rodando em sua própria infraestrutura. A vantagem principal aqui é a escalabilidade e o custo: após o investimento inicial no VPS, não há mensalidades por usuário ou licença.

Próximos passos recomendados incluem:

  • Configurar backups automáticos do banco de dados dolibarr_db e do diretório /var/www/dolibarr/documents.
  • Ajustar os módulos de acordo com a necessidade da empresa (Vendas, Compras, Estoque, RH).
  • Configurar o envio de emails via SMTP para notificações automáticas.

O Dolibarr é flexível e conta com uma comunidade ativa. Com esta base sólida em Ubuntu e Apache, sua empresa está preparada para digitalizar seus processos com segurança e eficiência.

Tags:
Esse tutorial foi útil?

Comentários (0)

Seja o primeiro a comentar.

Deixe seu comentário

Seu comentário será analisado antes de ser publicado.

0/2000
Voltar para Tutoriais