Pydio Cells for Cloudron

This package deploys Pydio Cells on Cloudron using the upstream Cells 5.0.2 binary.

Overview

Pydio Cells is a self-hosted document sharing and collaboration platform built around a Go microservice architecture.

This Cloudron package is designed as a fresh Cells 5 install:

• postgresql is the primary database addon.
• redis is enabled for external cache and queue support.
• localstorage provides persistent state under /app/data.
• The application listens on port 8080.
• TLS is terminated by Cloudron, so Cells runs with plain HTTP internally.

First Run

On first launch, the package starts the Cells setup flow at the app domain.

Recommended choices during setup:

• Use the Cloudron PostgreSQL addon details.
• Keep the site URL as the Cloudron app URL.
• Do not enable internal TLS.
• Avoid optional external services unless you intend to wire them explicitly later.

After setup completes, Cells stores its configuration in /app/data/pydio.json and subsequent restarts launch normally.

Runtime Layout

• /app/code contains the read-only packaged Cells binary and startup script.
• /app/data contains the persistent Cells configuration, working data, and logs.
• /run/cells is used for ephemeral runtime state.

Notes

• Cells 5 requires an explicit reverse URL behind a proxy; the package passes CLOUDRON_APP_ORIGIN during initial setup.
• The package no longer includes the old MySQL-specific reset logic or persistent debug loops from the legacy 4.x packaging.
• Allocate at least 2048 MB of memory for reliable operation.

Collabora

• .docx, .xlsx, and similar office editing requires a separate Collabora app.
• For a Collabora app running on the same Cloudron, do not use the public Collabora domain in the Cells plugin.
• Use the Collabora app's internal Cloudron hostname instead, or the Cells proxy can loop and fail with 400 Request Header Or Cookie Too Large.

Recommended Cells plugin values for same-Cloudron Collabora:

Libre Office Host: <collabora CLOUDRON_APP_HOSTNAME>
Libre Office Port: 9980
Libre Office SSL: off
Skip Certificate Verification: off
Base URL for the Cells backend: https://your-cells-domain

Get the internal Collabora hostname with:

cloudron exec --app collabora.example.com -- env | grep '^CLOUDRON_APP_HOSTNAME='

Example:

Libre Office Host: 53e4576a-57e8-4c0d-85b3-12ebca15ac00
Libre Office Port: 9980
Libre Office SSL: off
Base URL for the Cells backend: https://pydiocells.cloudron.uk

password reset (from local working device not app web terminal)

cloudron exec --app appname.domain.tld -- /app/code/bin/cells --config file:///app/data/pydio.json admin user set-pwd -u admin -p 'NEW_STRONG_PASSWORD'

License

This package is licensed under the AGPLv3, consistent with Pydio Cells.