Comment installer Pydio Cells sur AlmaLinux 9

Pydio Cells est une plateforme de partage de documents et de collaboration open-source pour votre organisation. Elle vous permet de partager des documents et des fichiers au sein de votre organisation et vous donne un contrôle total sur votre environnement de partage de documents.

Les Pydio Cells sont rapides en performance, peuvent gérer d’énormes tailles de transfert de fichiers et offrent une automatisation avancée des flux de travail.

Dans ce guide, nous allons vous montrer comment installer Pydio Cells sur un serveur Alma Linux 9. Vous allez installer Pydio Cells avec le serveur de base de données MariaDB et le serveur web Httpd.

Prérequis

Pour commencer ce guide, assurez-vous d’avoir les éléments suivants :

Un serveur Alma Linux 9
Un utilisateur non-root avec des privilèges d’administrateur
Un nom de domaine pointé vers l’adresse IP du serveur
Un SELinux avec le statut activé et permissif

Installation des dépendances

Avant d’installer Pydio Cells, vous devez installer des dépendances sur votre serveur Alma Linux. Cela inclut le dépôt EPEL, le serveur de base de données MariaDB, le serveur web Httpd et quelques outils système tels que wget et nano.

Tout d’abord, exécutez la commande ‘ dnf ‘ ci-dessous pour ajouter le dépôt EPEL et installer le serveur MariDB et le serveur web Httpd. Saisissez ‘ Y ‘ pour confirmer l’installation.

sudo dnf install epel-release mariadb-server httpd wget nano

install deps

Après l’installation, exécutez la commande ‘ systemctl ‘ ci-dessous pour démarrer, activer et vérifier le service ‘ httpd ‘. Vous verrez que le service ‘ httpd ‘ est en cours d’exécution et activé.

sudo systemctl enable --now httpd  
sudo systemctl status httpd

check httpd

Maintenant, exécutez la commande suivante pour démarrer et activer le service ‘ mariadb ‘. Ensuite, vérifiez-le pour vous assurer que le service est en cours d’exécution.

sudo systemctl enable --now mariadb  
sudo systemctl status mariadb

Dans la sortie suivante, vous pouvez voir que le serveur MariaDB est en cours d’exécution et activé.

check mariadb

Enfin, exécutez la commande ‘ firewall-cmd ‘ ci-dessous pour ouvrir les ports ‘ http ‘ et ‘ https ‘ sur votre système. Ensuite, rechargez les règles de firewalld pour appliquer vos modifications.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

Configuration du serveur MariaDB

Après avoir installé les dépendances, vous devez sécuriser l’installation du serveur MariaDB et créer une nouvelle base de données et un nouvel utilisateur pour l’installation du serveur Pydio Cells. Vous allez sécuriser MariaDB avec la commande ‘ mariadb-secure-installation ‘, puis créer une nouvelle base de données et un utilisateur via le client ‘ mariadb ‘.

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

sudo mariadb-secure-installation

Au cours du processus, vous serez interrogé sur les configurations suivantes :

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

Maintenant que le serveur MariaDB est sécurisé, vous allez créer une nouvelle base de données et un utilisateur pour l’installation de Pydio Cells.

Connectez-vous au serveur MariaDB avec la commande ‘ mariadb ‘ ci-dessous. Entrez votre mot de passe root MariaDB lorsqu’on vous le demande.

sudo mariadb -u root -p

Exécutez les requêtes suivantes pour créer une nouvelle base de données ‘ cells ‘, et un nouvel utilisateur ‘ pydio ‘, avec le mot de passe ‘p4ssw0rd’. Vous pouvez ajuster les détails de la base de données selon vos besoins.

CREATE DATABASE cells;  
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'p4ssw0rd';  
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';  
FLUSH PRIVILEGES;

create database

Maintenant, vérifiez les privilèges pour l’utilisateur ‘ pydio ‘ pour vous assurer qu’il a les permissions et privilèges sur la base de données ‘ cells ‘.

SHOW GRANTS FOR 'pydio'@'localhost';

Vous pouvez voir ci-dessous que la base de données ‘ cells ‘ est accessible via l’utilisateur ‘ pydio ‘.

check database

Tapez ‘quit’ pour quitter le serveur MariaDB.

Téléchargement de Pydio Cells

Avec la base de données MariaDB configurée, vous êtes prêt à télécharger Pydio Cells. Dans cette section, vous allez configurer l’utilisateur ‘pydio’, télécharger Pydio Cells, configurer le répertoire d’installation et les variables d’environnement, et permettre à Pydio Cells de s’exécuter sur les ports privilégiés.

Créez un nouvel utilisateur et un groupe ‘ pydio ‘ avec la commande suivante.

sudo useradd -m -s /bin/bash pydio

Créez de nouveaux répertoires ‘ /opt/pydio/bin ‘ et ‘ /var/cells ‘ avec la commande ci-dessous. Ensuite, changez la propriété des deux répertoires à l’utilisateur ‘ pydio ‘.

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

Maintenant, créez un nouveau fichier env ‘ /etc/profile.d/cells-env.sh ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/profile.d/cells-env.sh

Entrez le script suivant pour configurer les variables d’environnement pour Pydio Cells. Assurez-vous de changer l’adresse ‘ CELLS_EXTRERNAL ‘ pour correspondre au nom de domaine de votre installation Pydio.

export CELLS_WORKING_DIR=/var/cells  
export CELLS_BIND=127.0.0.1:8080  
export CELLS_EXTERNAL=https://cells.howtoforge.local

Une fois terminé, enregistrez et quittez le fichier.

Maintenant, exécutez la commande ci-dessous pour rendre le fichier env ‘ /etc/profile.d/cells-env.sh ‘ exécutable.

sudo chmod +x /etc/profile.d/cells-env.sh

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

export distribId=cells  
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/${distribId}/release/{latest}/linux-amd64/${distribId}

Une fois téléchargé, exécutez la commande suivante pour rendre le fichier binaire ‘ cells ‘ exécutable et lui permettre de se lier sur les ports privilégiés.

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

Maintenant, connectez-vous en tant qu’utilisateur ‘ pydio ‘ avec ce qui suit :

su - pydio

Vérifiez les variables d’environnement pour Pydio Cells avec ce qui suit - Assurez-vous que la sortie correspond aux variables d’environnement dans le fichier ‘ /etc/profile.d/cells-env.sh ‘.

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

check env

Enfin, vérifiez la version ‘cells’ avec la commande ci-dessous.

cells version

Dans la sortie suivante, vous pouvez voir la version de Pydio Cells.

check cells version

Installation de Pydio Cells via la ligne de commande

Maintenant, vous allez commencer à installer Pydio Cells depuis la ligne de commande. Avec la commande ‘ cells ‘, vous allez configurer l’installation de Pydio Cells avec la base de données MariaDB, configurer l’utilisateur administrateur et le mot de passe, et configurer l’emplacement de stockage pour stocker les données des utilisateurs.

Pour commencer, exécutez la commande ci-dessous pour configurer l’installation de Pydio Cells depuis le terminal.

cells configure --cli

Vous serez maintenant invité à effectuer les configurations suivantes :

Connexion à la base de données : sélectionnez via TCP, puis saisissez les détails de votre hôte de base de données MariaDB, port, utilisateur et mot de passe.
Configuration de MongoDB : saisissez n pour non.
Configuration de l’utilisateur administratif : saisissez votre utilisateur administrateur et mot de passe pour Pydio Cells.
Emplacement de stockage par défaut : appuyez sur ENTRÉE pour utiliser le défaut et continuer.

Après que le processus soit terminé, vous verrez la sortie suivante :

installing pydio cells

Configuration du fichier de service systemd pour Pydio Cells

À partir de l’étape précédente, vous pouvez démarrer Pydio Cells avec la commande ‘cells start’. Pour faciliter cela, vous allez plutôt utiliser ‘systemctl’ de systemd pour gérer le service Pydio Cells. Vous allez donc créer un nouveau fichier de service systemd.

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

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

Insérez la configuration ci-dessous pour exécuter Pydio Cells en tant que service systemd. Assurez-vous de changer ‘CELLS_EXTERNAL’ avec votre nom de domaine.

[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 ci-dessous pour recharger le gestionnaire systemd.

sudo systemctl daemon-reload

Enfin, exécutez la commande ‘ systemctl ‘ ci-dessous pour démarrer, activer et vérifier le service ‘ cells ‘.

sudo systemctl enable --now cells  
sudo systemctl status cells

Dans cette sortie, vous pouvez voir que le service ‘ cells ‘ est en cours d’exécution en arrière-plan en tant que service systemd.

systemd service

Configuration de Httpd en tant que proxy inverse

À ce stade, les Pydio Cells fonctionnent sur votre serveur Alma Linux sur le port ‘8080’. Pour le rendre accessible depuis le client, vous allez créer un fichier d’hôte virtuel Httpd en tant que proxy inverse pour le serveur Pydio Cells. Vous allez également générer des certificats SSL/TLS à partir de Letsencrypt pour sécuriser le transfert de données entre le client et le serveur Pydio Cells.

Tout d’abord, exécutez la commande ‘ dnf ‘ ci-dessous pour installer ‘certbot’ sur votre système.

sudo dnf install certbot -y

Maintenant, créez un nouveau répertoire racine web fictif et changez la propriété à l’utilisateur ‘ apache ‘.

sudo mkdir -p /var/www/html/cells/public_html  
sudo chown -R apache:apache /var/www/html/cells/public_html

Exécutez la commande ‘ certbot ‘ ci-dessous pour générer des certificats SSL/TLS pour Pydio Cells. Assurez-vous de changer l’adresse e-mail et le nom de domaine avec vos informations.

sudo certbot certonly --agree-tos --email [email protected] --no-eff-email --webroot -w /var/www/html/cells/public_html -d cells.howtoforge.local

Ensuite, créez une nouvelle configuration d’hôte virtuel Httpd ‘ /etc/httpd/conf.d/pydio.conf ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/httpd/conf.d/pydio.conf

Insérez la configuration ci-dessous et assurez-vous de changer l’option ‘ ServerName ‘ avec votre nom de domaine.

  
ServerName cells.howtoforge.local  
  
RewriteEngine On  
RewriteCond %{HTTPS} off  
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}  
  
RewriteCond %{SERVER_NAME} =cells.howtoforge.local  
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]  
  
  
  
ServerName cells.howtoforge.local  
AllowEncodedSlashes On  
RewriteEngine On  
  
# attention à 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 /var/log/httpd/error.log  
CustomLog /var/log/httpd/access.log combined  
  
SSLCertificateFile /etc/letsencrypt/live/cells.howtoforge.local/fullchain.pem  
SSLCertificateKeyFile /etc/letsencrypt/live/cells.howtoforge.local/privkey.pem  
#Include /etc/letsencrypt/options-ssl-apache.conf

Enregistrez le fichier et quittez l’éditeur une fois terminé.

Maintenant, exécutez la commande ‘ apachectl ‘ ci-dessous pour vérifier votre syntaxe Apache. Si vous avez une configuration Apache correcte, vous verrez une sortie ‘ Syntax is OK ‘.

sudo apachectl configtest

Enfin, exécutez la commande ‘systemctl’ ci-dessous pour redémarrer le serveur web ‘ httpd ‘ et appliquer vos modifications. Avec cela, votre installation de Pydio Cells devrait être terminée et accessible.

sudo systemctl restart httpd

setup httpd

Accéder à Pydio Cells

Ouvrez votre navigateur web et visitez le nom de domaine de votre installation Pydio Cells tel que https://cells.howtoforge.local. Si l’installation est réussie, vous verrez la page de connexion de Pydio Cells.

Saisissez votre utilisateur administrateur et votre mot de passe pour vous connecter.

Si vous avez les bonnes informations d’identification, vous verrez le tableau de bord utilisateur de Pydio Cells comme suit.

pydio dashboard

À partir de là, vous pouvez maintenant essayer de télécharger des fichiers depuis votre ordinateur local vers le serveur Pydio Cells. Dans la capture d’écran suivante, j’ai téléchargé des fichiers vers les Pydio Cells et cela a réussi.

pydio upload files

Conclusion

Félicitations ! Vous avez terminé l’installation de Pydio Cells sur le serveur Alma Linux 9. Vous avez les Pydio Cells fonctionnant avec le serveur de base de données MariaDB et le serveur web Httpd. De plus, vous avez également sécurisé l’installation de Pydio Cells avec HTTPS via Certbot et Letsencrypt.