Installazione su Ubuntu

Installare OpenProject Community Edition su Ubuntu è il modo più comune per avere un’installazione self-hosted completa e production-ready. La procedura supporta Ubuntu 22.04 LTS e 24.04 LTS.

Prerequisiti

  • Ubuntu 22.04 o 24.04 LTS (64-bit)
  • Minimo 4 GB RAM (consigliati 8 GB per 20+ utenti)
  • 2 vCPU minimo (consigliati 4)
  • 20 GB di storage (consigliati 100+ GB con allegati)
  • Swap di almeno 4 GB
  • Accesso root o sudo
  • Dominio puntato al server (per SSL)

Installazione

L’installazione ufficiale utilizza il repository packager.io gestito dal team OpenProject:

# 1. Download e registrazione chiave GPG
wget -qO- https://dl.packager.io/srv/opf/openproject/key | \
  gpg --dearmor | sudo tee /usr/share/keyrings/packager-io.gpg >/dev/null

# 2. Aggiungi repository
echo "deb [signed-by=/usr/share/keyrings/packager-io.gpg] \
  https://dl.packager.io/srv/deb/opf/openproject/stable/ubuntu 24.04 main" | \
  sudo tee /etc/apt/sources.list.d/openproject.list

# 3. Aggiorna e installa
sudo apt-get update
sudo apt-get install -y openproject

# 4. Avvia configuratore
sudo openproject configure

Configurazione iniziale

Il comando openproject configure ti guida nella configurazione di:

  • Server web: installerà e configurerà Apache2 con Passenger (default) o Nginx + Puma
  • Database: PostgreSQL locale (default) o remoto
  • Dominio: imposta l’URL pubblico (es. https://openproject.tuodominio.it)
  • SSL: configurazione automatica Let’s Encrypt
  • SMTP: server email per notifiche
  • Memoria: heap size per JVM (default 1 GB)

Post-installazione

Terminata la configurazione, OpenProject sarà raggiungibile all’URL configurato. Al primo accesso:

  1. Crea l’account amministratore
  2. Scegli la lingua e il fuso orario
  3. Configura le impostazioni di base (logo, colori, dominio email)
  4. Importa utenti via LDAP o aggiungili manualmente
  5. Crea il primo progetto

Comandi utili

# Stato del servizio
sudo systemctl status openproject

# Log
sudo journalctl -u openproject -f

# Re-configurare
sudo openproject reconfigure

# Backup
sudo openproject run backup

# Aggiornamento
sudo apt-get update && sudo apt-get upgrade openproject

⚠️ Nota: dopo aggiornamenti del sistema o di OpenProject, esegui sempre sudo openproject configure per riapplicare la configurazione.

Documentazione ufficiale: Packaged installation

Torna in alto