Installare Dolibarr via apt (pacchetto .deb)
Questa guida spiega come installare Dolibarr ERP/CRM su un server Ubuntu o Debian utilizzando apt e il pacchetto .deb ufficiale (DoliDeb). Questo metodo consente ad apt di risolvere automaticamente le dipendenze (Apache, MySQL/MariaDB, PHP) e offre una procedura guidata di configurazione durante l'installazione.
Da Ubuntu 18.04, il pacchetto dolibarr non è più incluso nei repository ufficiali Ubuntu/Debian. Il comando apt install dolibarr restituirà quindi un errore «pacchetto non trovato» sulle versioni recenti. Il metodo consigliato oggi consiste nel recuperare il pacchetto .deb ufficiale pubblicato dal progetto Dolibarr e installarlo con apt, che gestisce le dipendenze.
Ordina un Server
Per ospitare la tua istanza Dolibarr, HostMyServers offre diverse opzioni adatte:
- VPS Performance - Ideale per piccole strutture
- VPS NVMe - Ottimo rapporto qualità/prezzo
- Server Dedicati Eco - Per deployment con carico elevato
- Server Dedicati Performance - Prestazioni massime
Prerequisiti
- Accesso SSH come root o utente con sudo
- Sistema Ubuntu 24.04 LTS o Debian 12 64 bit
- Processore x64
- Minimo 1 GB RAM (2 GB consigliati per Dolibarr + database)
- Circa 5 GB di spazio disco libero (SSD consigliato)
- Porta 80 (e 443 per HTTPS) accessibile
Configurazione richiesta
| Componente | Minimo | Consigliato |
|---|---|---|
| RAM | 1 GB | 2-4 GB |
| CPU | 1 core | 2 core |
| Archiviazione | 5 GB SSD | 20 GB SSD |
| Rete | 100 Mbps | 1 Gbps |
Dolibarr si basa su uno stack LAMP: un server web (Apache consigliato), un database (MySQL / MariaDB) e PHP. Il pacchetto .deb installa e configura questi componenti per te tramite apt.
Connessione al Server
Assicurati di essere connesso al tuo server prima di iniziare. In base al tuo ambiente:
Connessione con nome utente e IP (porta predefinita)
Se il server utilizza la porta SSH standard (22):
ssh utente@indirizzo_ip_server
- utente: nome di accesso del server
- indirizzo_ip_server: indirizzo IP assegnato al tuo server
Connessione con una porta personalizzata
Se il server utilizza una porta SSH diversa dalla 22:
ssh -p numero_porta utente@indirizzo_ip_server
Connessione con una chiave PEM
Se è richiesta l'autenticazione con chiave PEM:
ssh -i /percorso/della/tua/chiave.pem utente@indirizzo_ip_server
Scegli il metodo adatto alla tua configurazione. Una volta connesso, puoi proseguire con l'installazione.
Aggiornamento del sistema
Aggiorna il tuo server prima di installare Dolibarr:
sudo apt-get update
sudo apt-get upgrade -y
Download del pacchetto .deb ufficiale
Recupera il pacchetto Debian/Ubuntu dal repository ufficiale Dolibarr. Al momento della stesura, l'ultima versione stabile è Dolibarr 23.0.3.
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_23.0.3-4_all.deb
Consulta l'indice dei pacchetti stabili per trovare la versione più recente e adatta il nome del file nei comandi.
Installazione via apt
Installa il pacchetto con apt install anteponendo al percorso ./. A differenza di dpkg -i, apt risolve e installa automaticamente le dipendenze (Apache, MariaDB/MySQL, PHP ed estensioni):
sudo apt install ./dolibarr_23.0.3-4_all.deb
Il prefisso ./ (o un percorso assoluto come /tmp/dolibarr_23.0.3-4_all.deb) è indispensabile: senza di esso apt cerca un pacchetto chiamato «dolibarr» nei repository e fallisce.
Procedura guidata di configurazione
Durante l'installazione appare una procedura guidata debconf che pone diverse domande. Usa le frecce, la barra spaziatrice per selezionare e Tab/Invio per confermare.
| Domanda | Risposta consigliata |
|---|---|
| Server web da riconfigurare automaticamente | Seleziona apache2 |
| Configurare il database con dbconfig-common? | Sì |
| Password dell'utente amministrativo del database (root MySQL/MariaDB) | Inserisci / conferma una password robusta |
Password applicativa del database dolibarr | Inserisci una password dedicata a Dolibarr |
Conserva con cura la password root del database e la password applicativa del database dolibarr: ti serviranno per la manutenzione o la risoluzione dei problemi.
Se l'installazione si interrompe per una dipendenza mancante, riparala e riavvia la configurazione:
sudo apt-get install -f -y
sudo dpkg-reconfigure dolibarr
Accesso all'interfaccia web
Al termine dell'installazione, apri un browser e accedi a:
http://indirizzo_ip_o_dominio/dolibarr/
Al primo accesso, Dolibarr avvia una procedura guidata di installazione nel browser:
- Verifica dell'ambiente (PHP, estensioni, permessi di scrittura)
- Parametri di connessione al database (precompilati da dbconfig-common)
- Creazione dell'account amministratore Dolibarr (login e password)
- Fine dell'installazione e accesso alla dashboard
Al termine della procedura, Dolibarr crea un file di blocco install.lock per impedirne la riesecuzione. Verifica che sia presente per proteggere l'accesso:
ls -l /var/lib/dolibarr/documents/install.lock
Configurazione del firewall
Se UFW è attivo, apri le porte web:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
Proteggere l'accesso con HTTPS
In produzione, proteggi l'accesso a Dolibarr con un certificato SSL. Il metodo più semplice con Apache è Certbot / Let's Encrypt:
sudo apt-get install -y certbot python3-certbot-apache
sudo certbot --apache -d il-tuo-dominio.it
Certbot configura automaticamente il virtual host Apache e il reindirizzamento HTTP → HTTPS.
Un certificato Let's Encrypt richiede un nome di dominio che punti all'IP del tuo server. Consulta la nostra guida per creare un record A verso l'IP del tuo server.
Comandi utili
| Comando | Descrizione |
|---|---|
sudo systemctl restart apache2 | Riavviare il server web |
sudo systemctl status apache2 | Stato di Apache |
sudo systemctl status mariadb | Stato del database |
sudo dpkg-reconfigure dolibarr | Riavviare la procedura di configurazione |
sudo tail -f /var/log/apache2/error.log | Seguire gli errori Apache/PHP |
Struttura dei file
| Percorso | Descrizione |
|---|---|
/usr/share/dolibarr/htdocs/ | Codice sorgente dell'applicazione |
/etc/dolibarr/conf.php | File di configurazione principale |
/etc/dolibarr/install.forced.php | Parametri imposti durante l'installazione |
/var/lib/dolibarr/documents/ | Documenti, PDF generati, backup e file install.lock |
/var/log/apache2/error.log | Registro degli errori del server web |
Aggiornamento di Dolibarr
Per passare a una versione più recente, scarica il nuovo pacchetto .deb e installalo sopra l'esistente — apt gestisce la migrazione:
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_NUOVA_VERSIONE_all.deb
sudo apt install ./dolibarr_NUOVA_VERSIONE_all.deb
Al primo accesso dopo un aggiornamento, Dolibarr potrebbe chiederti di avviare una procedura guidata di migrazione del database. Segui i passaggi proposti.
Esegui il backup del database e della cartella /var/lib/dolibarr/documents/ prima di qualsiasi aggiornamento:
sudo mysqldump -u root -p dolibarr > /root/dolibarr_backup.sql
sudo tar czf /root/dolibarr_documents.tar.gz /var/lib/dolibarr/documents
Risoluzione dei problemi
«Package not found» eseguendo apt install dolibarr
- Il pacchetto non esiste più nei repository: usa il file .deb ufficiale come descritto sopra.
- Assicurati di anteporre al nome
./o un percorso assoluto.
Errori di dipendenze durante l'installazione
- Ripara le dipendenze:
sudo apt-get install -f -y - Riavvia poi la configurazione:
sudo dpkg-reconfigure dolibarr
Impossibile accedere a /dolibarr/
- Verifica che Apache sia avviato:
sudo systemctl status apache2 - Verifica che il modulo PHP sia attivo:
sudo apachectl -M | grep php - Consulta il registro:
sudo tail -f /var/log/apache2/error.log
Errore di connessione al database
- Verifica che MariaDB/MySQL sia avviato:
sudo systemctl status mariadb - Controlla le credenziali in
/etc/dolibarr/conf.php - Testa la connessione:
mysql -u root -p -e "SHOW DATABASES;"
La procedura di installazione non appare più
- Se il file
install.lockesiste, la procedura è bloccata (comportamento normale). Per riavviarla volontariamente:sudo rm /var/lib/dolibarr/documents/install.lock(rimuovilo solo con cognizione di causa).