Instalação Pydio · 8 min read · Dec 15, 2025

Como Instalar Pydio Cells no Servidor Ubuntu 24.04

Pydio Cells é uma plataforma de Compartilhamento e Colaboração de Documentos auto-hospedada. Ele também oferece controle total sobre seu ambiente de compartilhamento de documentos. O Pydio Cells possui desempenho rápido, lida com tamanhos de transferência de arquivos enormes e fornece automação avançada de fluxo de trabalho.

Neste guia, vamos orientá-lo na instalação do Pydio Cells no servidor Ubuntu 24.04 com o banco de dados MariaDB e Apache como um proxy reverso.

Pré-requisitos

Antes de começar, certifique-se de que você possui o seguinte:

  • Um servidor Ubuntu 24.04.
  • Um usuário não-root com privilégios de administrador.
  • Um nome de domínio apontado para um endereço IP do servidor.

Instalando dependências

Antes de instalar o Pydio Cells, você deve instalar as dependências em seu sistema Ubuntu. Isso inclui o servidor de banco de dados MariaDB e o servidor web Apache.

Primeiro, execute o seguinte comando apt para atualizar seu índice de pacotes do Ubuntu e instalar as dependências para o Pydio Cells. Com este comando, você instalará o servidor web Apache, o servidor de banco de dados MariaDB e o Certbot para gerar certificados SSL/TLS.

sudo apt update 
sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget

Digite Y para confirmar a instalação.

install deps

Após a conclusão da instalação, verifique o status do serviço Apache com o seguinte:

sudo systemctl is-enabled apache2 
sudo systemctl status apache2

Você pode ver abaixo que o servidor web Apache está habilitado e em execução.

check apache

Agora verifique o status do servidor MariaDB com o comando abaixo.

sudo systemctl is-enabled mariadb 
sudo systemctl status mariadb

Abaixo, o servidor MariaDB está em execução e habilitado.

check mariadb

Configurando o servidor MariaDB

Após instalar o servidor MariaDB, você irá proteger o MariaDB com a ferramenta mariadb-secure-installation. Em seguida, você criará um novo banco de dados e um usuário para o Pydio Cells.

Para proteger a instalação do servidor MariaDB, execute o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Você será questionado sobre a configuração do servidor MariaDB abaixo:

  • Mudar a autenticação local para unix_socket? Digite n.
  • Configurar a nova senha root do MariaDB. Digite y para confirmar, em seguida, digite a nova senha para a sua instalação do servidor MariaDB.
  • Remover usuário anônimo? Digite y para confirmar.
  • Remover o banco de dados de teste padrão da instalação? Digite y para confirmar.
  • Proibir login root do MariaDB de conexões remotas? Digite y para confirmar.
  • Recarregar privilégios de tabela e aplicar as alterações? Digite y e pressione ENTER.

Agora execute o comando do cliente mariadb abaixo para fazer login no servidor MariaDB. Digite sua senha root quando solicitado.

sudo mariadb -u root -p

Em seguida, execute as seguintes consultas para criar um novo banco de dados cellsdb, um usuário cells e a senha p4ssword. Certifique-se de alterar os detalhes abaixo com suas informações.

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

create database

Agora execute a consulta abaixo para garantir que o usuário cells@localhost possa acessar o banco de dados cellsdb.

SHOW GRANTS FOR cells@localhost;

Você deve ver uma saída semelhante abaixo:

check user

Digite quit para sair do servidor MariaDB.

Instalando Pydio Cells

Nesta seção, você criará um novo usuário pydio, configurará variáveis de ambiente e, em seguida, fará o download e instalará o Pydio Cells.

Adicione um novo usuário pydio com o seguinte comando:

sudo useradd -m -s /bin/bash pydio

Em seguida, execute o comando abaixo para criar um novo diretório /opt/pydio/bin e /var/cells, e mudar a propriedade para o usuário pydio.

sudo mkdir -p /opt/pydio/bin /var/cells  
sudo chown -R pydio: /opt/pydio/bin /var/cells

Agora execute o seguinte comando para criar o arquivo env /etc/profile.d/cells-env.sh e torná-lo executável. Este arquivo será executado quando o usuário fizer login.

sudo tee -a /etc/profile.d/cells-env.sh << EOF  
export CELLS_WORKING_DIR=/var/cells  
export CELLS_BIND=127.0.0.1:8080  
export CELLS_EXTERNAL=https://cells.howtoforge.local  
EOF  
sudo chmod 0755 /etc/profile.d/cells-env.sh

Em seguida, faça login como usuário pydio e verifique as variáveis de ambiente $CELLS_WORKING_DIR, $CELLS_BIND e $CELLS_EXTERNAL. Certifique-se de que cada uma aponte para o valor correto, conforme no arquivo /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

check env

Agora execute o comando abaixo para baixar o arquivo binário do Pydio para /opt/pydio/bin/cells.

export distribId=cells  
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/

Torne o arquivo /opt/pydio/bin/cells executável e saia do usuário pydio atual.

chmod a+x /opt/pydio/bin/cells  
exit

Após isso, execute o comando setcap abaixo para permitir que o Pydio use portas privilegiadas (0-1024) e crie um symlink para o /usr/local/bin/cells.

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

Faça login como usuário pydio novamente e execute o comando cells abaixo para verificar a versão do Pydio Cells.

su - pydio  
cells version

Como você pode ver abaixo, o Pydio Cells 4.4.3 está instalado.

check pydio version

Configurando Pydio Cells

Agora que você baixou o Pydio Cells, você irá configurá-lo e integrá-lo com o servidor de banco de dados MariaDB e criar um usuário administrador para a instalação do Pydio Cells. Isso pode ser feito através da linha de comando cells.

Execute o comando cells abaixo para instalar e configurar a instalação do Pydio Cells.

cells configure --cli
  • Selecione TCP para a conexão do banco de dados e digite seu banco de dados MariaDB, usuário e senha.
  • Digite N para o suporte ao MongoDB. Neste caso, você irá construir e instalar um único Pydio Cells.
  • Pressione ENTER para usar a configuração de armazenamento padrão.
  • Digite um novo usuário administrador, endereço de e-mail e senha para sua instalação do Pydio Cells.

setup pydio

Após a conclusão da instalação, você verá a mensagem Instalação concluída.

pydio cells installed

Executando Pydio Cells como um serviço systemd

Nesta seção, você criará e configurará um arquivo de serviço systemd para o Pydio Cells. Com isso, você pode gerenciar facilmente o Pydio Cells com o comando systemctl.

Crie um novo arquivo de serviço /etc/systemd/system/cells.service com o editor nano.

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

Adicione a seguinte configuração ao arquivo e certifique-se de alterar a variável de ambiente CELLS_EXTERNAL com seu nome de domínio de destino.

[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

# Adicione variáveis de ambiente
Environment=CELLS_WORKING_DIR=/var/cells
Environment=CELLS_BIND=127.0.0.1:8080
Environment=CELLS_EXTERNAL=https://cells.howtoforge.local

[Install]
WantedBy=multi-user.target

Salve o arquivo e saia do editor.

Agora execute o comando systemctl abaixo para recarregar o gerenciador systemd e aplicar suas alterações.

sudo systemctl daemon-reload

Inicie e habilite o serviço cells com o comando abaixo. Em seguida, verifique o status do cells para garantir que o serviço está em execução.

sudo systemctl enable --now cells  
sudo systemctl status cells

cells as systemd service

Configurando o Apache como um proxy reverso

Após o Pydio Cells ser executado como um serviço systemd, você criará um novo arquivo de host virtual do Apache como um proxy reverso para o Pydio Cells. Você também precisará habilitar os módulos do Apache com o comando a2enmod.

Primeiro, execute o comando a2enmod abaixo para habilitar os módulos do Apache. Neste caso, você habilitará módulos para SSL e proxy reverso.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

enable modules

Agora crie um novo arquivo de host virtual /etc/apache2/sites-available/cells.conf com o seguinte comando nano.

sudo nano /etc/apache2/sites-available/cells.conf

Insira a configuração abaixo para configurar o Apache como um proxy reverso para o Pydio Cells. Certifique-se de alterar a opção ServerName com seu nome de domínio de destino.


    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # esteja ciente disso
    # Permitir proxy reverso via certificados autoassinados
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## A ordem das diretivas importa.
    # Se o Cells não estiver rodando com https, considere usar ws em vez de wss
    ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon

    ## Esta condição de reescrita é necessária se usar Cells-Sync
    # RewriteCond %{HTTP:Content-Type} =application/grpc [NC]
    # RewriteRule /(.*) h2://localhost:8080/$1 [P,L]

    ProxyPass "/" "https://127.0.0.1:8080/" 
    ProxyPassReverse "/" "https://127.0.0.1:8080/"

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Salve e saia do arquivo quando terminar.

Em seguida, execute o comando a2ensite abaixo para ativar o host virtual cells.conf e verificar sua configuração do Apache. Se você tiver uma configuração adequada do Apache, verá uma saída Syntax is OK.

sudo a2ensite cells.conf  
sudo apachectl configtest

Por fim, execute o comando systemctl abaixo para reiniciar o servidor web Apache e aplicar suas alterações.

sudo systemctl restart apache2

setup apache

Protegendo o Pydio Cells com HTTPS

O Pydio Cells é acessível via HTTPS. Portanto, você deve habilitar HTTPS em seu arquivo de host virtual do Apache. Nesta seção, você gerará certificados SSL/TLS com certbot para proteger a instalação do Pydio Cells.

Para proteger o Pydio Cells com HTTPS, execute o comando certbot abaixo. Certifique-se de alterar o nome de domínio e o endereço de e-mail abaixo com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d cells.howtoforge.local

Após o processo ser concluído, seus certificados SSL/TLS estarão disponíveis no diretório /etc/letsencrypt/live/domain.com.

Agora abra seu navegador e visite seu nome de domínio https://cells.howtoforge.local/. Se sua instalação for bem-sucedida, você será solicitado a acessar a página de login do Pydio Cells.

Digite seu usuário administrador e senha, e clique em ENTER.

login

Você verá o painel do Pydio Cells como o seguinte:

dashboard

Conclusão

Parabéns! Você completou a instalação do Pydio Cells no servidor Ubuntu 24.04. Você tem o Pydio Cells em funcionamento com o servidor de banco de dados MariaDB e Apache como um proxy reverso. Por fim, você também protegeu o Pydio Cells com HTTPS através do Certbot e Letsencrypt.

Share: X/Twitter LinkedIn
#Instalação Pydio

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.