Operating System CentOS

Pydio 7 Is End of Life: Install Pydio Cells on Rocky Linux 9 or AlmaLinux 9

The PHP-based Pydio 7/8 is discontinued. Here is how to install its successor, Pydio Cells, on Rocky Linux 9 or AlmaLinux 9 with MariaDB, HTTPS and systemd.

Pydio 7 and its successor Pydio 8 (also known as Pydio Core, and before that AjaXplorer) were PHP file-sharing applications. They are discontinued: the project announced end of life for Pydio Core on 31 December 2019, with no security fixes after that date, and the pydio-core repository on GitHub was archived on 25 November 2020. The RPM repository that older tutorials install from is no longer a safe source, and CentOS 7 itself reached end of life in June 2024. Do not deploy Pydio 7 or 8 on a server that faces the internet.

The maintained successor is Pydio Cells, a rewrite in Go by the same company, released under the AGPLv3 and actively developed (the 5.x series is current at the time of writing). It ships as a single binary that includes its own web server, so there is no Apache or PHP to configure. This guide installs Cells on Rocky Linux 9 or AlmaLinux 9 following the project's deployment guide for RHEL-like systems: a dedicated user, MariaDB, a Let's Encrypt certificate and a systemd service.

Requirements

  • Rocky Linux 9 or AlmaLinux 9, 64-bit, with a user that has sudo rights. The official guide is written on Rocky Linux 9.
  • 4 GB RAM and 2 CPU cores as recommended by Pydio; SSD storage sized for your files.
  • A domain name, for example files.example.com, with an A record pointing at the server.
  • Ports 80 and 443 free. Nothing else may be listening on them, because Cells terminates HTTPS itself.

Step 1: Create the user and directories

Cells should run as an unprivileged user. Create it together with a directory for the binary and one for data, and set the working directory variable system-wide:

sudo useradd -m -s /bin/bash pydio
sudo mkdir -p /opt/pydio/bin /var/cells/certs
sudo chown -R pydio:pydio /opt/pydio /var/cells
sudo tee -a /etc/profile.d/cells-env.sh << EOF
export CELLS_WORKING_DIR=/var/cells
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh

Confirm that the variable is set for the new user. The command should print /var/cells:

sudo su - pydio -c 'echo $CELLS_WORKING_DIR'

Step 2: Install MariaDB and create the database

The MariaDB 10.5 package in the distribution repositories meets Cells' requirements:

sudo dnf install mariadb-server wget
sudo systemctl enable --now mariadb
sudo mysql_secure_installation

Open a database shell:

sudo mysql -u root -p

Create the database and its user, replacing the password:

CREATE DATABASE cells;
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'choose-a-strong-password';
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';
FLUSH PRIVILEGES;
exit

Step 3: Download the Cells binary

Download the latest release as the pydio user. The {latest} part of the URL is literal; the download server redirects it to the current version:

sudo su - pydio
wget -O /opt/pydio/bin/cells 'https://download.pydio.com/latest/cells/release/{latest}/linux-amd64/cells'
chmod a+x /opt/pydio/bin/cells
exit

Back as your admin user, allow the binary to bind to ports below 1024 and make the command available system-wide:

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

Check the installed version:

sudo su - pydio -c 'cells version'

Step 4: Run the installer

Open port 8080 temporarily for the installer (this rule is not permanent and disappears on the next firewall reload):

sudo firewall-cmd --add-port=8080/tcp

Start the configuration as the pydio user:

sudo su - pydio
cells configure

Choose either the browser install, which serves a wizard at https://203.0.113.10:8080 (accept the self-signed certificate), or the command-line install, which asks the same questions in the terminal. In both cases:

  • Database: TCP connection to localhost:3306, database cells, user pydio and the password from step 2.
  • Administrator: choose a login and a strong password for the first Cells user.
  • Leave the storage defaults, which place data under /var/cells.

After a command-line install, start the server in the foreground and log in at https://203.0.113.10:8080 to confirm it works:

cells start

Stop it with Ctrl+C before continuing. Always stop a foreground instance this way before starting another one.

Step 5: Bind to your domain with Let's Encrypt

Open the web ports permanently:

sudo firewall-cmd --permanent --add-service=http --add-service=https
sudo firewall-cmd --reload

Still as the pydio user, declare the public site:

cells configure sites

Answer the prompts as follows:

  1. Choose to create a new site.
  2. Bind to port 443 and enter your domain name as the address.
  3. Select the option to generate a certificate with Let's Encrypt, enter your email address and accept the terms.
  4. Enable the redirect from HTTP to HTTPS, review and save.

If your DNS or network setup is not settled yet, pick the Let's Encrypt staging endpoint first; it has far more generous rate limits while you debug. Run cells start once more, open https://files.example.com, check that the certificate is valid, then stop the server with Ctrl+C and exit the pydio shell.

Step 6: Run Cells as a systemd service

Create /etc/systemd/system/cells.service:

[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
Environment=CELLS_WORKING_DIR=/var/cells

[Install]
WantedBy=multi-user.target

Enable and start it:

sudo systemctl daemon-reload
sudo systemctl enable --now cells

Verify and troubleshoot

Follow the service log and the application log:

sudo journalctl -fu cells -S -1h
sudo tail -200f /var/cells/logs/pydio.log
  • Timeout in the browser: the port is blocked. Check firewalld and any firewall in your hosting control panel.
  • A blank page saying "Access denied": the official guide attributes this to SELinux in enforcing mode and advises permissive mode. Test with sudo setenforce 0; if that fixes it, review the denials with sudo ausearch -m avc -ts recent before deciding whether to make the change permanent in /etc/selinux/config.
  • Certificate not issued: the A record has not propagated, or port 80 is not reachable from the internet.

The official Install Cells on CentOS/RHEL guide covers further variations, such as a newer MariaDB from the vendor repository.

Updating Cells

Because Cells is a single binary, an update replaces that file. Back up the database and /var/cells first, read the release notes for the version you are moving to, then stop the service, download the new binary over the old one as in step 3, run the setcap command again (file capabilities are lost when the file is replaced) and start the service.

Frequently asked questions

Can I migrate data from Pydio 7 or 8?

Not by upgrading in place: Cells is a different application with a different data model. Your files are ordinary files on disk in the old installation, so the dependable route is to install Cells separately and import the files into new workspaces, then recreate users and shares. Check the Pydio documentation for the migration tooling available for your versions before planning anything more automated.

Do I need Apache, nginx or PHP?

No. Cells contains its own web server and handles TLS itself. A reverse proxy is optional and only useful when other sites must share ports 80 and 443 on the same server.

Is Pydio Cells free?

The Cells Home edition used in this guide is open source under the AGPLv3. Pydio also sells Cells Enterprise with additional features and support; the download URL differs only in the distribution name.

Which sync and mobile clients work with it?

Use the current Cells clients from Pydio. The old PydioSync desktop client and the apps written for Pydio 8 target the discontinued PHP server.

Share story:

Continue reading other guides on How VPS.