WARNING This documentation is for Cells v3. Looking for Pydio Cells v4 docs?

Cells ships as a set of precompiled static binaries, one for each operating system. The only required dependency is a MySQL database.


  • CPU: AMD 64bit architecture only, 2 core or more are recommended.
  • RAM: 4GB RAM
  • Disk: SSD is highly recommended for storage.
  • Supported OS:
    • Debian Like: Debian 10 (Buster) LTS, Debian 9 (Stretch) LTS / Raspbian Stretch, Debian 8 (Jessie) LTS / Raspbian Jessie, Ubuntu 20.04 (Focal Fossa), Ubuntu 18.04 (Bionic Beaver), Ubuntu 16.04 (Xenial Xerus)
    • RHEL: RHEL7, CentOS7, RHEL6, CentOS 6
    • MacOSX: 10.13/11.1
    • Windows: 10 (Cells Home only)

Important Settings

  • Dedicated OS user: never run Cells as "root" user!
  • Ulimit: the number of allowed open files must be greater than 2048. For production use, a minimum of 8192 is recommended (see ulimit -n).

MySQL/Maria DB versions

Supported server versions:

Creating a database and a privileged user

CREATE USER 'pydio'@'localhost' IDENTIFIED BY '<your-password-here>';
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';

Important Settings

Always ensure that the database is created with character set and collation set to UTF8.

Make sure not to leave the max_connections to its default value (151) for production we advise at least 500, for a better understanding see MySQL manual.

Network requirements


Cells provides its own webserver as a unified Gateway to public-facing services. As such, unlike old versions of Pydio, you do not need Apache or equivalent.

The Gateway will "bind" to a TCP Port like a standard web server. The port number used is defined in the ./cells configure sites command, or directly as a parameter of the start command in the command line interface.

This is the port that need to be opened in your firewall to make Cells accessible outside the server.

Port Default CLI Flag
Gateway 8080 --bind


Cells uses TCP/IP connections to communicate between services. Most of the services use random available ports. The following are using pre-defined ports, that can be overridden in all commands that refer to services in the command line interface (eg start, admin, ...)

Port Default CLI Flag
Registry 8000 --port_registry
Broker 8003 --port_broker
Back to top