Install Cells on MacOSX

Created on 2021/03/31, cells, installation
Category: 

This guide describes the steps required to have Pydio Cells running on macOS.

Requirements

Database

You can skip this step if you already have a database.

You can use either MySQL (>= 5.7) or MariaDB (>= 10.3) as your Database Management System. Both are available in Homebrew.

brew install mysql or brew install mariadb

Installation

Pydio

Download Pydio Cells Binary on your server/machine using the following command:

# Use this url as is, it will be resolved automatically to latest version

wget https://download.pydio.com/latest/cells/release/{latest}/darwin-amd64/cells
chmod +x cells

Port 80 & 443

You can only use these ports if you are connected as an Admin User or root.

By default, Apache is running on macOS, so you need to ensure that it - or no other webservers - is bound to these ports.

To stop the default Apache, you can use:

sudo apachectl stop

To prevent Apache from starting during launch, you may use:

sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist

Database configuration

In this section, we assume you have installed MySql server. Adapt the following steps to your current installation.

# Go to mysql mode
sudo mysql -u root
# Create new user and set password
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'your password goes here';
CREATE DATABASE cells;
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';
FLUSH PRIVILEGES;

Starting with Pydio

First, give execution rights to the binary. For instance, you can use sudo chmod u+x <binary>.

Then run the installer with the following command:

cells configure

Once you have finished the configuration, you can start Cells with:

cells start

By default, to access the webui use your domain or address under the port 8080 (for instance https://domain:8080).

To configure a different interface and port for cells, run the following command.

cells configure sites

Troubleshooting

  • The database service might not be started, you can look at its status using : brew services list and then brew services start mysql if needed.
  • You can look at the webserver's error file located in ~/.config/pydio/cells/logs/caddy_errors.log.