Installation · 8 min read · Dec 15, 2025

Comment installer Pydio Cells sur un serveur Ubuntu 24.04

Pydio Cells est une plateforme de partage et de collaboration de documents auto-hébergée. Elle vous donne également un contrôle total de votre environnement de partage de documents. Pydio Cells offre des performances rapides, gère des tailles de transfert de fichiers énormes et fournit une automatisation avancée des flux de travail.

Dans ce guide, nous vous guiderons à travers l’installation de Pydio Cells sur le serveur Ubuntu 24.04 avec la base de données MariaDB et Apache comme proxy inverse.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

  • Un serveur Ubuntu 24.04.
  • Un utilisateur non-root avec des privilèges d’administrateur.
  • Un nom de domaine pointé vers une adresse IP de serveur.

Installation des dépendances

Avant d’installer Pydio Cells, vous devez installer les dépendances sur votre système Ubuntu. Cela inclut le serveur de base de données MariaDB et le serveur web Apache.

Tout d’abord, exécutez la commande apt suivante pour mettre à jour votre index de paquets Ubuntu et installer les dépendances pour Pydio Cells. Avec cette commande, vous installerez le serveur web Apache, le serveur de base de données MariaDB et Certbot pour générer des certificats SSL/TLS.

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

Entrez Y pour confirmer l’installation.

install deps

Après l’installation, vérifiez l’état du service Apache avec la commande suivante :

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Vous pouvez voir ci-dessous que le serveur web Apache est activé et en cours d’exécution.

check apache

Maintenant, vérifiez l’état du serveur MariaDB avec la commande ci-dessous.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Ci-dessous, le serveur MariaDB est en cours d’exécution et activé.

check mariadb

Configuration du serveur MariaDB

Après avoir installé le serveur MariaDB, vous allez sécuriser MariaDB avec l’utilitaire mariadb-secure-installation. Ensuite, vous créerez une nouvelle base de données et un utilisateur pour Pydio Cells.

Pour sécuriser l’installation du serveur MariaDB, exécutez la commande mariadb-secure-installation ci-dessous.

sudo mariadb-secure-installation

Vous serez interrogé sur la configuration du serveur MariaDB ci-dessous :

  • Passer l’authentification locale à unix_socket ? Entrez n.
  • Configurer le nouveau mot de passe root de MariaDB. Entrez y pour confirmer, puis tapez le nouveau mot de passe pour votre déploiement de serveur MariaDB.
  • Supprimer l’utilisateur anonyme ? Entrez y pour confirmer.
  • Supprimer la base de données de test par défaut du déploiement ? Entrez y pour confirmer.
  • Interdire la connexion root de MariaDB à partir de connexions distantes ? Entrez y pour confirmer.
  • Recharger les privilèges de table et appliquer les changements ? Entrez y et appuyez sur ENTRÉE.

Maintenant, exécutez la commande client mariadb ci-dessous pour vous connecter au serveur MariaDB. Entrez votre mot de passe root lorsque vous y êtes invité.

sudo mariadb -u root -p

Ensuite, exécutez les requêtes suivantes pour créer une nouvelle base de données cellsdb, un utilisateur cells, et le mot de passe p4ssword. Assurez-vous de changer les détails ci-dessous avec vos informations.

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

create database

Maintenant, exécutez la requête ci-dessous pour vous assurer que l’utilisateur cells@localhost peut accéder à la base de données cellsdb.

SHOW GRANTS FOR cells@localhost;

Vous devriez voir une sortie similaire ci-dessous :

check user

Tapez quit pour quitter le serveur MariaDB.

Installation de Pydio Cells

Dans cette section, vous allez créer un nouvel utilisateur pydio, configurer des variables d’environnement, puis télécharger et installer Pydio Cells.

Ajoutez un nouvel utilisateur pydio avec la commande suivante :

sudo useradd -m -s /bin/bash pydio

Ensuite, exécutez la commande ci-dessous pour créer un nouveau répertoire /opt/pydio/bin et /var/cells, et changer la propriété à l’utilisateur pydio.

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

Maintenant, exécutez la commande suivante pour créer le fichier env /etc/profile.d/cells-env.sh et le rendre exécutable. Ce fichier sera exécuté lorsque l’utilisateur se connectera.

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

Ensuite, connectez-vous en tant qu’utilisateur pydio et vérifiez les variables d’environnement $CELLS_WORKING_DIR, $CELLS_BIND, et $CELLS_EXTERNAL. Assurez-vous que chacune pointe vers la valeur correcte comme dans le fichier /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR
echo $CELLS_BIND
echo $CELLS_EXTERNAL

check env

Maintenant, exécutez la commande ci-dessous pour télécharger le fichier binaire Pydio dans /opt/pydio/bin/cells.

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

Rendez le fichier /opt/pydio/bin/cells exécutable et quittez l’utilisateur pydio actuel.

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

Après cela, exécutez la commande setcap ci-dessous pour permettre à Pydio d’utiliser des ports de privilège (0-1024) et créer un lien symbolique vers /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

Connectez-vous à nouveau en tant qu’utilisateur pydio et exécutez la commande cells ci-dessous pour vérifier la version de Pydio Cells.

su - pydio
cells version

Comme vous pouvez le voir ci-dessous, Pydio Cells 4.4.3 est installé.

check pydio version

Configuration de Pydio Cells

Maintenant que vous avez téléchargé Pydio Cells, vous allez le configurer et l’intégrer avec le serveur de base de données MariaDB et créer un utilisateur admin pour l’installation de Pydio Cells. Cela peut être fait via la ligne de commande cells.

Exécutez la commande cells ci-dessous pour installer et configurer l’installation de Pydio Cells.

cells configure --cli
  • Sélectionnez TCP pour la connexion à la base de données et tapez votre base de données MariaDB, utilisateur et mot de passe.
  • Entrez N pour le support MongoDB. Dans ce cas, vous allez construire et installer un Pydio Cells unique.
  • Appuyez sur ENTRÉE pour utiliser la configuration de stockage par défaut.
  • Entrez un nouvel utilisateur admin, une adresse e-mail et un mot de passe pour votre installation de Pydio Cells.

setup pydio

Après l’installation, vous verrez le message Installation terminée.

pydio cells installed

Exécution de Pydio Cells en tant que service systemd

Dans cette section, vous allez créer et configurer un fichier de service systemd pour Pydio Cells. Avec cela, vous pouvez facilement gérer Pydio Cells avec la commande systemctl.

Créez un nouveau fichier de service /etc/systemd/system/cells.service avec l’éditeur nano.

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

Ajoutez la configuration suivante au fichier et assurez-vous de changer la variable d’environnement CELLS_EXTERNAL avec votre nom de domaine cible.

[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

# Ajouter des variables d'environnement
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

Enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande systemctl ci-dessous pour recharger le gestionnaire systemd et appliquer vos modifications.

sudo systemctl daemon-reload

Démarrez et activez le service cells avec la commande ci-dessous. Ensuite, vérifiez l’état de cells pour vous assurer que le service est en cours d’exécution.

sudo systemctl enable --now cells
sudo systemctl status cells

cells as systemd service

Configuration d’Apache en tant que proxy inverse

Après que Pydio Cells fonctionne en tant que service systemd, vous allez créer un nouveau fichier d’hôte virtuel Apache en tant que proxy inverse pour Pydio Cells. Vous devrez également activer les modules Apache avec la commande a2enmod.

Tout d’abord, exécutez la commande a2enmod ci-dessous pour activer les modules Apache. Dans ce cas, vous allez activer les modules pour SSL et le proxy inverse.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

enable modules

Maintenant, créez un nouveau fichier d’hôte virtuel /etc/apache2/sites-available/cells.conf avec la commande nano suivante.

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

Insérez la configuration ci-dessous pour configurer Apache en tant que proxy inverse pour Pydio Cells. Assurez-vous de changer l’option ServerName avec votre nom de domaine cible.


    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # soyez conscient de cela
    # Autoriser le proxy inverse via des certificats auto-signés
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## L'ordre des directives est important.
    # Si Cells ne fonctionne pas avec https, envisagez d'utiliser ws au lieu de wss
    ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon

    ## Cette condition de réécriture est requise si vous utilisez 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

Enregistrez et quittez le fichier une fois terminé.

Ensuite, exécutez la commande a2ensite ci-dessous pour activer l’hôte virtuel cells.conf et vérifier votre configuration Apache. Si vous avez une configuration Apache correcte, vous verrez une sortie Syntax is OK.

sudo a2ensite cells.conf
sudo apachectl configtest

Enfin, exécutez la commande systemctl ci-dessous pour redémarrer le serveur web Apache et appliquer vos modifications.

sudo systemctl restart apache2

setup apache

Sécurisation de Pydio Cells avec HTTPS

Pydio Cells est accessible via HTTPS. Vous devez donc activer HTTPS sur votre fichier d’hôte virtuel Apache. Dans cette section, vous allez générer des certificats SSL/TLS avec certbot pour sécuriser l’installation de Pydio Cells.

Pour sécuriser Pydio Cells avec HTTPS, exécutez la commande certbot ci-dessous. Assurez-vous de changer le nom de domaine et l’adresse e-mail ci-dessous avec vos informations.

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

Après le processus, vos certificats SSL/TLS seront disponibles dans le répertoire /etc/letsencrypt/live/domain.com.

Maintenant, ouvrez votre navigateur web et visitez votre nom de domaine https://cells.howtoforge.local/. Si votre installation est réussie, vous serez invité à la page de connexion de Pydio Cells.

Entrez votre utilisateur admin et votre mot de passe, puis cliquez sur ENTRÉE.

login

Vous verrez le tableau de bord de Pydio Cells comme suit :

dashboard

Conclusion

Félicitations ! Vous avez terminé l’installation de Pydio Cells sur le serveur Ubuntu 24.04. Vous avez Pydio Cells opérationnel avec le serveur de base de données MariaDB et Apache en tant que proxy inverse. Enfin, vous avez également sécurisé Pydio Cells avec HTTPS via Certbot et Letsencrypt.

Share: X/Twitter LinkedIn
#Installation

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.