CentOS/RHEL Systems

This guide describes the steps required to have Pydio Cells running on a CentOs/RHEL 7 server.

Prerequisites

Database

The only hard requirement is a running MySQL DB server. We recommend a recent version of MariaDB or the MySQL community server.

MariaDB

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

Double check that the system specifications are OK and follow the detailed instructions.

After installation, you should enable and start the service:

sudo systemctl enable mariadb
sudo systemctl start mariadb

MySQL

Install MySQL 5.6 official community release repository.

sudo rpm -i http://dev.mysql.com/get/mysql-community-release-el7-5.noarch.rpm
sudo yum update

# install mysql-community-server package
sudo yum install mysql-community-server

# Set mysqld to start after reboot
sudo systemctl enable mysqld

# start the service now
sudo systemctl start mysqld

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>';
CREATE DATABASE cells;
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';
FLUSH PRIVILEGES;

SELinux

There is no available configuration of SELinux for Pydio Cells. Please make sure that SELinux is disabled or running in permissive mode.

To temporary disable SELinux: sudo setenforce 0.

You can also permanently disable SELinux in /etc/selinux/config.

Dedicated User

It is recommended to use a dedicated non-admin user to run Pydio Cells.

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
sudo passwd pydio

To switch to this user:

su - pydio

Install Pydio Cells

# As pydio user
wget https://download.pydio.com/pub/cells/release/1.6.1/linux-amd64/cells
chmod u+x cells

If you want to use the standard HTTP (80) and/or HTTPS (443) ports, you have to give corresponding permissions to the binary file:

# As your admin  user
sudo setcap 'cap_net_bind_service=+ep' /home/pydio/cells

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

INTERNAL_URL : address where the application http server is bound to. It MUST contain a server name and a port.
EXTERNAL_URL : url that the end user will use to connect to the application.

Example:
If you want your application to run on the localhost at port 8080 and use the url mycells.mypydio.com, then set INTERNAL_URL to localhost:8080 and EXTERNAL_URL to http://mycells.mypydio.com (or https)
After the install is successfully done, if you ever have to stop Pydio Cells and want to run it again just run:

You can now run the installer:

# As pydio user
./cells install

Follow the short set of instructions. You can also refer to this page to get more details.
Once the installation as finished, you might have to stop and restart the application (typically if you have chosen the CLI installer).

./cells start

Note that is not the prefered way to run Pydio Cells in a production context.

Troubleshooting

Frontend

SELinux is enforced

If, after a successful installation and when you try to navigate to the main application page with your browser, you land on a blank page with following message:

Access denied.

ensure you have modified SELinux to be in permissive mode.

Back to top