Installazione software · 7 min read · Dec 15, 2025

Come installare Pydio Cells su Ubuntu 24.04 Server

Pydio Cells è una piattaforma di condivisione e collaborazione di documenti auto-ospitata. Ti offre anche il pieno controllo del tuo ambiente di condivisione documenti. I Pydio Cells hanno prestazioni elevate, gestiscono dimensioni di trasferimento file enormi e forniscono automazione avanzata dei flussi di lavoro.

In questa guida, ti guideremo attraverso l’installazione di Pydio Cells sul server Ubuntu 24.04 con il database MariaDB e Apache come reverse proxy.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

  • Un server Ubuntu 24.04.
  • Un utente non root con privilegi di amministratore.
  • Un nome di dominio puntato a un indirizzo IP del server.

Installazione delle dipendenze

Prima di installare Pydio Cells, devi installare le dipendenze sul tuo sistema Ubuntu. Questo include il server di database MariaDB e il server web Apache.

Per prima cosa, esegui il seguente comando apt per aggiornare l’indice dei pacchetti di Ubuntu e installare le dipendenze per Pydio Cells. Con questo comando, installerai il server web Apache, il server di database MariaDB e Certbot per generare certificati SSL/TLS.

sudo apt update 
sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget

Immetti Y per confermare l’installazione.

install deps

Dopo che l’installazione è completata, controlla lo stato del servizio Apache con il seguente:

sudo systemctl is-enabled apache2 
sudo systemctl status apache2

Puoi vedere qui sotto che il server web Apache è abilitato e in esecuzione.

check apache

Ora controlla lo stato del server MariaDB con il comando qui sotto.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Qui sotto il server MariaDB è in esecuzione e abilitato.

check mariadb

Configurazione del server MariaDB

Dopo aver installato il server MariaDB, dovrai mettere in sicurezza MariaDB con l’utilità mariadb-secure-installation. Poi, creerai un nuovo database e un utente per Pydio Cells.

Per mettere in sicurezza l’installazione del server MariaDB, esegui il comando mariadb-secure-installation qui sotto.

sudo mariadb-secure-installation

Ti verrà chiesto di configurare il server MariaDB qui sotto:

  • Passare l’autenticazione locale a unix_socket? Immetti n.
  • Imposta la nuova password di root di MariaDB. Immetti y per confermare, quindi digita la nuova password per il tuo deployment del server MariaDB.
  • Rimuovere l’utente anonimo? Immetti y per confermare.
  • Rimuovere il database di test predefinito dal deployment? Immetti y per confermare.
  • Vietare il login di root di MariaDB da connessioni remote? Immetti y per confermare.
  • Ricaricare i privilegi delle tabelle e applicare le modifiche? Immetti y e premi INVIO.

Ora esegui il comando del client mariadb qui sotto per accedere al server MariaDB. Immetti la tua password di root quando richiesto.

sudo mariadb -u root -p

Successivamente, esegui le seguenti query per creare un nuovo database cellsdb, un utente cells e la password p4ssword. Assicurati di cambiare i dettagli qui sotto con le tue informazioni.

CREATE DATABASE cellsdb;  
CREATE USER cells@localhost IDENTIFIED BY 'cellsp4ssword';  
GRANT ALL PRIVILEGES ON cellsdb.* TO cells@localhost;  
FLUSH PRIVILEGES;

create database

Ora esegui la query qui sotto per assicurarti che l’utente cells@localhost possa accedere al database cellsdb.

SHOW GRANTS FOR cells@localhost;

Dovresti vedere un output simile qui sotto:

check user

Digita quit per uscire dal server MariaDB.

Installazione di Pydio Cells

In questa sezione, creerai un nuovo utente pydio, imposterai le variabili d’ambiente e poi scaricherai e installerai Pydio Cells.

Aggiungi un nuovo utente pydio con il seguente comando:

sudo useradd -m -s /bin/bash pydio

Poi, esegui il comando qui sotto per creare una nuova directory /opt/pydio/bin e /var/cells, e cambia la proprietà all’utente pydio.

sudo mkdir -p /opt/pydio/bin /var/cells  
sudo chown -R pydio: /opt/pydio/bin /var/cells

Ora esegui il seguente comando per creare il file env /etc/profile.d/cells-env.sh e renderlo eseguibile. Questo file verrà eseguito quando l’utente accede.

sudo tee -a /etc/profile.d/cells-env.sh << EOF  
export CELLS_WORKING_DIR=/var/cells  
export CELLS_BIND=127.0.0.1:8080  
export CELLS_EXTERNAL=https://cells.howtoforge.local  
EOF  
sudo chmod 0755 /etc/profile.d/cells-env.sh

Successivamente, accedi come utente pydio e controlla le variabili d’ambiente $CELLS_WORKING_DIR, $CELLS_BIND e $CELLS_EXTERNAL. Assicurati che ciascuna punti al valore corretto come nel file /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

check env

Ora esegui il comando qui sotto per scaricare il file binario di Pydio in /opt/pydio/bin/cells.

export distribId=cells  
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/

Rendi il file /opt/pydio/bin/cells eseguibile e esci dall’attuale utente pydio.

chmod a+x /opt/pydio/bin/cells  
exit

Dopo di che, esegui il comando setcap qui sotto per consentire a Pydio di utilizzare porte privilegiate (0-1024) e crea un symlink a /usr/local/bin/cells.

sudo setcap 'cap_net_bind_service=+ep' /opt/pydio/bin/cells  
sudo ln -s /opt/pydio/bin/cells /usr/local/bin/cells

Accedi di nuovo come utente pydio e esegui il comando cells qui sotto per controllare la versione di Pydio Cells.

su - pydio  
cells version

Come puoi vedere qui sotto, Pydio Cells 4.4.3 è installato.

check pydio version

Configurazione di Pydio Cells

Ora che hai scaricato Pydio Cells, lo configurerai e lo integrerai con il server di database MariaDB e creerai un utente admin per l’installazione di Pydio Cells. Questi possono essere fatti tramite la riga di comando cells.

Esegui il comando cells qui sotto per installare e configurare l’installazione di Pydio Cells.

cells configure --cli
  • Seleziona TCP per la connessione al database e digita il tuo database MariaDB, utente e password.
  • Immetti N per il supporto di MongoDB. In questo caso, costruirai e installerai un singolo Pydio Cells.
  • Premi INVIO per utilizzare la configurazione di archiviazione predefinita.
  • Immetti un nuovo utente admin, indirizzo email e password per la tua installazione di Pydio Cells.

setup pydio

Dopo che l’installazione è completata, vedrai il messaggio Installazione completata.

pydio cells installed

Esecuzione di Pydio Cells come servizio systemd

In questa sezione, creerai e configurerai un file di servizio systemd per Pydio Cells. Con questo, puoi gestire facilmente Pydio Cells con il comando systemctl.

Crea un nuovo file di servizio /etc/systemd/system/cells.service con l’editor nano.

sudo nano /etc/systemd/system/cells.service

Aggiungi la seguente configurazione al file e assicurati di cambiare la variabile d’ambiente CELLS_EXTERNAL con il tuo nome di dominio target.

[Unit]
Description=Pydio Cells
Documentation=https://pydio.com
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/opt/pydio/bin/cells

[Service]
User=pydio
Group=pydio
PermissionsStartOnly=true
AmbientCapabilities=CAP_NET_BIND_SERVICE
ExecStart=/opt/pydio/bin/cells start
Restart=on-failure
StandardOutput=journal
StandardError=inherit
LimitNOFILE=65536
TimeoutStopSec=5
KillSignal=INT
SendSIGKILL=yes
SuccessExitStatus=0
WorkingDirectory=/home/pydio

# Aggiungi variabili d'ambiente
Environment=CELLS_WORKING_DIR=/var/cells
Environment=CELLS_BIND=127.0.0.1:8080
Environment=CELLS_EXTERNAL=https://cells.howtoforge.local

[Install]
WantedBy=multi-user.target

Salva il file e esci dall’editor.

Ora esegui il comando systemctl qui sotto per ricaricare il gestore systemd e applicare le tue modifiche.

sudo systemctl daemon-reload

Avvia e abilita il servizio cells con il comando qui sotto. Poi, controlla lo stato di cells per assicurarti che il servizio sia in esecuzione.

sudo systemctl enable --now cells  
sudo systemctl status cells

cells as systemd service

Configurazione di Apache come reverse proxy

Dopo che Pydio Cells è in esecuzione come servizio systemd, creerai un nuovo file di host virtuale Apache come reverse proxy per Pydio Cells. Dovrai anche abilitare i moduli Apache con il comando a2enmod.

Per prima cosa, esegui il comando a2enmod qui sotto per abilitare i moduli Apache. In questo caso, abiliterai i moduli per SSL e reverse proxy.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

enable modules

Ora crea un nuovo file di host virtuale /etc/apache2/sites-available/cells.conf con il seguente comando nano.

sudo nano /etc/apache2/sites-available/cells.conf

Inserisci la configurazione qui sotto per impostare Apache come reverse proxy per Pydio Cells. Assicurati di cambiare l’opzione ServerName con il tuo nome di dominio target.


    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # fai attenzione a questo
    # Consenti reverse proxy tramite certificati autofirmati
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## L'ordine delle direttive è importante.
    # Se Cells non è in esecuzione con https, considera di usare ws invece di wss
    ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon

    ## Questa condizione di riscrittura è necessaria se si utilizza Cells-Sync
    # RewriteCond %{HTTP:Content-Type} =application/grpc [NC]
    # RewriteRule /(.*) h2://localhost:8080/$1 [P,L]

    ProxyPass "/" "https://127.0.0.1:8080/" 
    ProxyPassReverse "/" "https://127.0.0.1:8080/"

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Salva ed esci dal file quando hai finito.

Successivamente, esegui il comando a2ensite qui sotto per attivare l’host virtuale cells.conf e verificare la tua configurazione Apache. Se hai una corretta configurazione Apache, vedrai un output Syntax is OK.

sudo a2ensite cells.conf  
sudo apachectl configtest

Infine, esegui il comando systemctl qui sotto per riavviare il server web Apache e applicare le tue modifiche.

sudo systemctl restart apache2

setup apache

Messa in sicurezza di Pydio Cells con HTTPS

Pydio Cells è accessibile tramite HTTPS. Quindi devi abilitare HTTPS nel tuo file di host virtuale Apache. In questa sezione, genererai certificati SSL/TLS con certbot per mettere in sicurezza l’installazione di Pydio Cells.

Per mettere in sicurezza Pydio Cells con HTTPS, esegui il comando certbot qui sotto. assicurati di cambiare il nome di dominio e l’indirizzo email qui sotto con le tue informazioni.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d cells.howtoforge.local

Dopo che il processo è completato, i tuoi certificati SSL/TLS saranno disponibili nella directory /etc/letsencrypt/live/domain.com.

Ora apri il tuo browser web e visita il tuo nome di dominio https://cells.howtoforge.local/. Se la tua installazione ha avuto successo, ti verrà mostrata la pagina di accesso di Pydio Cells.

Inserisci il tuo utente admin e la password, e fai clic su INVIO.

login

Vedrai il dashboard di Pydio Cells come il seguente:

dashboard

Conclusione

Congratulazioni! Hai completato l’installazione di Pydio Cells sul server Ubuntu 24.04. Hai Pydio Cells in esecuzione con il server di database MariaDB e Apache come reverse proxy. Infine, hai anche messo in sicurezza Pydio Cells con HTTPS tramite Certbot e Letsencrypt.

Share: X/Twitter LinkedIn

Ricevi i nuovi post nella tua casella di posta.

Nessuno spam. Disiscriviti in qualsiasi momento.