You must have an available MySQL database, along with a privileged user (for instance 'pydio').
  Supported databases are:
   - MariaDB version 10.3 and above,
   - MySQL version 5.7 and above (except 8.0.22 that has a bug preventing Cells to run correctly).

sudo apt update
sudo apt install -y mariadb-server

mariadb  Ver 15.1 Distrib 10.6.23-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper

sudo mysql_secure_installation

sudo mariadb -u root -p

CREATE DATABASE cells;
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON cells.* TO 'pydio'@'localhost';
FLUSH PRIVILEGES;

SET GLOBAL max_connections = 1000;
SHOW VARIABLES LIKE "max_connections";
SET GLOBAL max_prepared_stmt_count = 131056;
SHOW VARIABLES LIKE "max_prepared_stmt_count";

Variable_name   Value
max_connections 1000
Variable_name   Value
max_prepared_stmt_count 131056

MYSQL_PWD=q1w2e3r4 mariadb -upydio -e "SELECT VERSION(); SHOW DATABASES;"

VERSION()
10.6.23-MariaDB-0ubuntu0.22.04.1
Database
cells
information_schema

sudo useradd -m -s /bin/bash pydio
sudo mkdir -p /opt/pydio/bin /var/cells
sudo chown -R pydio: /opt/pydio /var/cells
sudo tee -a /etc/profile.d/cells-env.sh << EOF
export CELLS_WORKING_DIR=/var/cells
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh

sudo su - pydio
echo $CELLS_WORKING_DIR

/var/cells

wget -O /opt/pydio/bin/cells "https://download.pydio.com/latest/cells/release/{latest}/linux-amd64/cells"
chmod a+x /opt/pydio/bin/cells

sudo setcap 'cap_net_bind_service=+ep' /opt/pydio/bin/cells
sudo ln -s /opt/pydio/bin/cells /usr/local/bin/cells

cells version

Pydio Cells Home Edition
 Version:       5.1.0
 Built:         30 Sep 26 12:11 +0000
 Git commit:    56383d15577f371a463d3692408532ab49e909ac
 OS/Arch:       linux/amd64
 Go version:    go1.26.7

sudo su - pydio
cells configure

Welcome to Pydio Cells Home Edition installation
Pydio Cells Home Edition (v5.1.0) will be configured to run on this machine.

## Database Connection
Use the arrow keys to navigate: ↓ ↑ → ←
? Database Connection Type:
  ▸ MySQL/MariaDB - TCP
    PostgreSQL    - TCP
    MySQL/MariaDB - Socket
    PostgreSQL    - Socket
↓   SQLite        - File
✔ MySQL/MariaDB - TCP

✔ Database Hostname: 127.0.0.1█          ← 默认值，改输 localhost
Database Hostname: localhost
✔ Database Port: 3306█                   ← 保持默认，回车
✔ Database Name: cells█                  ← 保持默认，回车
✔ Database User: root█                   ← 改输 pydio
✔ Database Password (leave empty if not needed): █
✔ Database Password (leave empty if not needed): ********
✔ Successfully connected to the database

? Do you wish to configure a MongoDB connection (better for scalability and required for clustering deployment)? [y/N]
... Starting installation now
... Created main database

## Administrative User Configuration
✔ Admin Login: admin█
Admin Login: admin
✗ Admin Password: █
Admin Password: ********
Confirm Password: ********

## Default storage location
Use the arrow keys to navigate: ↓ ↑ → ←
? Your files will be stored on local filesystem under '/var/cells/data'. Do you want to change this?:
  ▸ It's ok for me, use default location
    Select another local folder
    Store data in S3-compatible storage (requires api key/secret)
✔ It's ok for me, use default location

## Applying configuration
... Starting installation now
... Generating secrets
... Created main database
... Created default datasources
Adding admin credentials to config, to be inserted at next start
... Creation of logs directory
✔ Configuration done

## Software is ready to run!
Cells will be accessible through the following URLs:
https://10.89.73.2:8080, https://127.0.0.1:8080, https://localhost:8080, https://0.0.0.0:8080
Edit these URLs by running 'cells configure sites' command.

Now use 'cells start' to start the server.

✔ Installation Finished

sudo vi /etc/systemd/system/cells.service

[Unit]
Description=Pydio Cells
Documentation=https://pydio.com
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/opt/pydio/bin/cells

[Service]
User=pydio
Group=pydio
PermissionsStartOnly=true
AmbientCapabilities=CAP_NET_BIND_SERVICE
ExecStart=/opt/pydio/bin/cells start
Restart=on-failure
StandardOutput=journal
StandardError=inherit
LimitNOFILE=65536
TimeoutStopSec=5
KillSignal=INT
SendSIGKILL=yes
SuccessExitStatus=0
WorkingDirectory=/home/pydio
# Add environment variables
Environment=CELLS_WORKING_DIR=/var/cells

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now cells

systemctl status cells --no-pager

● cells.service - Pydio Cells
     Loaded: loaded (/etc/systemd/system/cells.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2026-10-22 04:37:36 UTC; 9min ago
       Docs: https://pydio.com
   Main PID: 6722 (cells)
      Tasks: 17 (limit: 94371)
     Memory: 287.9M
        CPU: 9.093s
             └─6722 /opt/pydio/bin/cells start

ss -tlnp | grep -E ":8080|:8030"

LISTEN 0      4096               *:8030             *:*    users:(("cells",pid=6722,fd=7))
LISTEN 0      4096               *:8080             *:*    users:(("cells",pid=6722,fd=41))

curl -sk -o /dev/null -w "HTTP %{http_code}\n" https://127.0.0.1:8080/
curl -sk -o /dev/null -w "HTTP %{http_code}\n" https://127.0.0.1:8080/auth/login
curl -sk https://127.0.0.1:8080/ | grep -oE "<title>[^<]*</title>"

HTTP 200
HTTP 200
<title>Pydio Cells</title>

cells admin user search -u admin

+-------+----------+---------+------+--------------------------------------+
| NAME  | IS GROUP | PROFILE | PATH |                 UUID                 |
+-------+----------+---------+------+--------------------------------------+
| admin |          | admin   | /    | 67f533a1-3811-4441-a4e2-293e0bd19041 |
+-------+----------+---------+------+--------------------------------------+
Showing 1 result

printf "pydio cells webdav closed-loop test 2026-10-22\nsecond line for md5 check\n" > /home/pydio/b1dav.txt
curl -sku admin:q1w2e3r4 -T /home/pydio/b1dav.txt "https://127.0.0.1:8080/dav/common-files/b1dav.txt" -o /dev/null -w "PUT HTTP %{http_code}\n"
curl -sku admin:q1w2e3r4 -X PROPFIND -H "Depth: 1" "https://127.0.0.1:8080/dav/common-files/" -w "\nPROPFIND HTTP %{http_code}\n"
curl -sku admin:q1w2e3r4 "https://127.0.0.1:8080/dav/common-files/b1dav.txt" -w "\nGET HTTP %{http_code}\n"
md5sum /home/pydio/b1dav.txt

PUT HTTP 201
<D:href>/common-files/</D:href>
<D:href>/common-files/b1dav.txt</D:href>
<D:href>/common-files/davtest.txt</D:href>
PROPFIND HTTP 207
pydio cells webdav closed-loop test 2026-10-22
second line for md5 check
GET HTTP 200
44226377e75915d2088f114d75886cbd  /home/pydio/b1dav.txt

# 基础无 TLS 配置（纯 HTTP 访问）
proxyconfig:
  binds:
    - 0.0.0.0:8080
dbconnectiontype: tcp
dbtcphostname: localhost
dbtcpport: 3306
dbtcpname: cells
dbtcpuser: pydio
dbtcppassword: q1w2e3r4
frontendlogin: admin
frontendpassword: q1w2e3r4
frontendrepeatpassword: q1w2e3r4

cells configure --yaml /var/cells/install.yaml --exit_after_install

⚠ [Keyring] Auto-creating new value for pydio.grpc.user-key/keyring.master
✅ Successfully upgraded configurations

Welcome to Pydio Cells Home Edition installation
Pydio Cells Home Edition (v5.1.0) will be configured to run on this machine.
## Performing Installation
... Install config loaded from /var/cells/install.yaml
Starting installation now
Generating secrets
Created main database
Created default datasources
Adding admin credentials to config, to be inserted at next start
Creation of logs directory
✔ Non-interactive install performed inside '/var/cells', you can now use the start command.

/var/cells/
├── pydio.json          # 主配置文件（数据库 DSN、默认数据源、站点绑定、服务参数）
├── cells-vault-key     # 配置加密密钥（务必备份，丢失后加密配置不可恢复）
├── pydio-vault.json    # 加密配置库
├── certs/              # 站点 TLS 证书（自签名证书与 rootCA）
├── caddy/              # 内嵌网关（Caddy）运行数据
├── data/               # 文件存储：pydiods1（公共文件）、personal（用户私有）、
│                       #   cellsdata、thumbs（缩略图）、versions（历史版本）、binaries
├── logs/               # 文件日志（pydio.log 等）
└── services/           # 各微服务运行数据

cells configure sites

tail -200f /var/cells/logs/pydio.log   # 主文件日志
ls -lsah /var/cells/logs/              # 各微服务独立日志
journalctl -fu cells -S -1h            # systemd 单元日志

sudo systemctl disable --now cells
sudo rm -f /etc/systemd/system/cells.service
sudo systemctl daemon-reload
sudo mariadb -e "DROP DATABASE cells; DROP USER 'pydio'@'localhost';"
sudo rm -rf /var/cells /opt/pydio
sudo rm -f /usr/local/bin/cells /etc/profile.d/cells-env.sh
sudo userdel -r pydio