How to deploy the Pydio InstantApp with Object Storage

Deploying Pydio with Object Storage

This page shows you how to spawn a Pydio application with Object Storage.

Requirements
You have an account and are logged into console.scaleway.com
You have configured your SSH Key
You have generated your API Key

Pydio is an open source software solution for file sharing and synchronization. With intuitive user interfaces (web/mobile/desktop).

The Pydio application will store files in our Object Storage to you have an highly available and unlimited storage.

There are four steps to deploy the Pydio application:

Deploying Pydio
Configuring Pydio
Login and starting using Pydio
Configuring Pydio with Object Storage

Deploying Pydio

Before starting, click the “Create a Server” button in the control panel.

Control Panel

You will land on the server-creation page where you can choose the Pydio image in the InstantApps tab for your Cloud Instance:

Control Panel

Choose the server type and click on the Create a Server button. This action starts your server with Etherpad pre-installed.

Installing and Configuring Pydio

When your server is running, you can see the server’s IP address in the server list on the control panel. Connect to the server via SSH and prepare the installation of Pydio:

1 . Configure the repository of Pydio and update the arp cache:

apt-get install apt-transport-https
echo "deb https://download.pydio.com/pub/linux/debian/ bionic main" > /etc/apt/sources.list.d/pydio.list
wget -qO - https://download.pydio.com/pub/linux/debian/key/pubkey | apt-key add -
apt-get update

2 . Install Pydio and its requirements:

apt-get install pydio
apt-get install pydio-all
apt-get install php-xml php-dom mariadb-server

3 . Initialize the MariaDB database server:

mysql_secure_installation

4 . Create the database and user account for Pydio:

mysql -u root -p
CREATE DATABASE pydio;
CREATE USER "pydio" IDENTIFIED BY "secret_password";
GRANT ALL PRIVILEGES ON pydio.* TO "pydio";

5 . Quit the MariaDB client by typying \q.

6 . Open the file /usr/share/pydio/plugins/access.s3/manifest.xml and add a nl-ams Region to it:

[...]
<server_settings>
	[...]
	<param name="REGION" group="CONF_MESSAGE[Location]" type="select" choices="nl-ams|Scaleway AMS, [...] label="CONF_MESSAGE[Region]" description="CONF_MESSAGE[S3 storage region]" mandatory="false"/>
  [...]

Configuring the admin access

1 . Open your web browser and type http://YOUR_SERVER_IP/pydio to start the configuration of Pydio.

2 . Configure the admin user:

Pydio admin

Configuring the database

Pydio stores its configuration in a MySQL database. Enter the credentials of the database that you have created before.

Pydio storage

Configuring global options

The application let you customize some global parameters, like the language that is used by default:

Pydio options

Click on the button to complete the installation.

Login and start using Pydio

Pydio is now installed and ready to use. Enter the username and password you set during the configuration and login

Pydio home

Configuring Pydio with Object Storage

1 . Click the Storage button in the Scaleway control panel.

2 . Click Create a Bucket to create a bucket for Pydio to store files inside.

3 . Name your bucket and validate your bucket creation (a bucket name must contain only alphanumeric and lowercase characters)

4 . Generate an API Key to have the required access_key and secret_key.

5 . In Pydio, click on the three dots, to display the menu, then click on Settings.

Pydio menu

6 . Move the curser to the left edge of the page, to display the menu and click on Workspaces followed by + Workspace.

7 . Click on Workspace based by… Driver, select ** S3 Amazon Web Service as driver and fill-in with your the details of your API Key.

KEY: your access key
SECRET KEY: your secret_key
REGION: Scaleway AMS
BUCKET: The name of the bucket you created

Pydio settings

8 . Scroll down to the Custom Storage section and fill in the information about the storage endpoint:

STORAGE URL: https://s3.nl-ams.scw.cloud

Important: Edit the Storage URL parameter to the region of your bucket. It can either be s3.fr-par.scw.cloud (Paris, France), s3.nl-ams.scw.cloud (Amsterdam, The Netherlands) or s3.pl-waw.scw.cloud (Warsaw, Poland).