Launching Amazon AMI (Enterprise)
We expose below the specificities of the AMI custom setup. For further details, please refer to the other sections of this administration guide.
Cells ED AMI on AWS Marketplace
You can find a ready-to-use Amazon Machine Image (AMI) on the Amazon Web Services Marketplace following this link:
This Cells Enterprise package is based on Amazon Linux 2 AMI and has been enriched with necessary third parties and configuration to provide an easy to run instance of the Cells server out of the box.
If you want to give a first quick glance at Cells with no hassle, just launch the AMI on a
t2-medium EC2 instance, with no user data, no extra mounted volume and setting security groups so that, the instance:
- Can reach the internet (to download updates)
- Can be reached on port 443
- Can be reached via SSH
- Is on a private network with a private IP address
You will have a ready to install instance at
https://<ec2-public-ip> after a couple of minutes.
You can quickly finalise the installation by:
- Accepting EULA
- Pasting your licence key
- Use embedded local db with:
- Host: localhost
- Port: 3306
- DB: cells
- User: pydio
- Password: cells
- Define an admin and leave advanced parameters untouched.
The Pydio Cells AMI comes with 3 default users:
- ec2-user: the default Amazon user that is to be used to connect using the key pair you define when launching a new instance. She has sudo rights without password for all commands.
- pydio: the user that launches the Cells server. She has no sudo rights and no pre-defined password. You should use this user when you locally use the
cellscommand line interface.
- root: the root user. You normally do not have to log as this user.
- install-cells.service: launched at boot, when your instantiate a new Cells ED AMI, it launches the installation process. After successful installation, it starts and enables the cells service, and disables itself before exiting.
- cells.service: runs the cells server as a systemd daemon. The
install-cells.serviceenables and starts this service when finalising the install.
They are 2 main paths that are used by Cells:
/opt/pydio/bin: Pydio Cells binary
/opt/pydio/conf: Installation configuration files
/var/cells: The application working directory with: runtime configuration, logs, technical persistence and, by default, your data.
If you provide an additional EBS volume when you launch the AMI (see installation instructions), it is automatically mounted at this location before install.
A MySQL DB is the only hard requirement to run a Pydio Cells instance.
As a convenience, the Pydio Cells AMI embbed an installed and configured MariaDB 10.2 server that is provided by the Amazon Linux 2 LAMP topic.
There are 2 users
pydio, all other configurations follow the
mysql_secure_installation best practices.
There is one default
cells DB, on which the
pydio user has all privileges.
You might use this database during your test phase. Before going live, it is recommanded to either:
- Rather use an RDS instance
- Change the passwords for both users
Hint: default mysql password for pydio user is
cells, root user has no password
By default, the application is installed using the "self-signed certificate" mode.
It is recommended to run the Cells server behind a reverse proxy that exposes a valid TLS certificate when in production.
If you do not provide a valid registered FQDN via "user data" upon launch, it is then configured using the Amazon automatically provided public IP address and the frontend is publicly available at
Cells Clean Re-install
If you are in testing mode and want to reset your vanilla install, you only need to:
- Stop cells service
- Drop and recreate the DB
cells installas user
- Restart the Cells service by running
sudo systemctl restart cells