Debian Systems

WARNING This documentation is for Cells v1. Looking for Pydio Cells v2 docs?

This guide describes the steps required to have Pydio Cells running on Debian 8, Debian 9 and Debian 10.


OS requirements

You need the 64-bit version of one of these Debian or Raspbian versions:

  • Debian 10 (buster) LTS
  • Stretch 9 (stable) / Raspbian Stretch
  • Jessie 8 (LTS) / Raspbian Jessie

Dedicated User

It's highly recommend to run Pydio Cells with a dedicated user.

In this guide, we use pydio and its home directory /home/pydio.

In order to create a new user and its home directory execute this command:

sudo useradd -m pydio


Pydio Cells can be installed with both MySQL Server (v5.6 or higher) and MariaDB (v10.2 or higher).


sudo dpkg -i mysql-apt-config_0.8.9-1_all.deb

To access the correct repository :

  • Select the MySQL Server & Cluster option and press Enter
  • Select the correct option (mysql-5.6 or mysql-5.7) and press Enter
  • Back on the first list, select Ok and press Enter
sudo apt update
sudo apt install mysql-server



If you are using Debian 10 you can skip this step, MariaDB 10.3 is the default packages

We currently use MariaDB 10.3, here is the official installation guide on the MariaDB website.

Simply enter there your system specifications and follow the detailed instructions.

In production system, you probably want to secure your installation by executing:


Post install configuration

By default, a new database will be created by the system during the installation process. You only need a user with database management permissions.

If you would rather do it manually, you may create a dedicated user and an empty database by executing the following SQL queries :

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

Installation and configuration

sudo chmod u+x cells

If you need to use the standard http (80) or https (443) port, please execute this command:

setcap 'cap_net_bind_service=+ep' cells

Switch to the pydio user to run the installation and start the app:

su - pydio

Execute the command below and follow the instructions.

Before you start installing here's two of the most important parameters that you need to understand:

INTERNAL_URL(other) : address where the application http server is bound to. It MUST contain a server name and a port, should be of this form <ip-or-domain>:<port>.
EXTERNAL_URL : url the end user will use to connect to the application.
If you want your application to run on the localhost at port 8080 and use the url, then set INTERNAL_URL to localhost:8080 and EXTERNAL_URL to (or https)

After the install is successfully done, if you ever have to stop Pydio Cells and want to run it again just run:

./cells install

You can refer to this page to get more details on the installation process.

After the install is successfully done, if you ever have to stop Pydio Cells and want to run it again just run:

./cells start


Generally, you might want to have a look at the log file that is located in ~/.config/pydio/cells/logs.

Database server issue

After start, the web page is unreachable and you see a bunch of errors starting with: ERROR pydio.grpc.meta Failed to init DB provider {"error": "Error 1071: Specified key was too long; max key length is 767 bytes handling data_meta_0.1.sql"}.

You might have an unsupported version of the mysql server: you should use MySQL server version 5.6 or higher or MariaDB version 10.2 or higher.


You see this error: /lib/x86_64-linux-gnu/ version 'GLIBC_2.14' not found

The version of libc6 is outdated. Run these commands to upgrade it.

sudo apt-get update
sudo apt-get install libc6
Back to top