Guia de Instalação do Passbolt em Hospedagem Compartilhada (AlmaLinux 9)

Pré-requisitos

Para a execução deste processo, o usuário deve:

Instrução de Trabalho

A seguir, são apresentados os passos necessários para a instalação do Passbolt CE a partir do código fonte:

Passo 1: Atualização do Sistema e Instalação de Dependências

Atualize o sistema e instale os pacotes essenciais:

dnf update -y
dnf install -y git composer php php-cli php-fpm php-gd php-mbstring php-json php-curl php-xml php-intl

Passo 2: Clonagem do Repositório do Passbolt

Clone o repositório oficial do Passbolt a partir do GitHub para o diretório desejado (por exemplo, /var/www/passbolt):

git clone https://github.com/passbolt/passbolt_api.git /var/www/passbolt

Passo 3: Instalação das Dependências via Composer

Navegue até o diretório do Passbolt e instale as dependências PHP utilizando o Composer:

cd /var/www/passbolt
composer install --no-dev

Passo 4: Configuração do Ambiente

Copie o arquivo de exemplo de configuração para iniciar a customização do ambiente:

cp .env.example .env

Em seguida, edite o arquivo .env para definir os parâmetros essenciais, por exemplo:

# Exemplo de configuração no arquivo .env
DATABASE_URL="mysql://passboltuser:senha_segura@localhost/passboltdb"
APP_FULL_BASE_URL="https://seu-dominio.com"
# Outras variáveis de ambiente necessárias...

Passo 5: Configuração do Banco de Dados

Crie o banco de dados e o usuário no MariaDB. Por exemplo:

mysql -u root -p
CREATE DATABASE passboltdb;
CREATE USER 'passboltuser'@'localhost' IDENTIFIED BY 'senha_segura';
GRANT ALL PRIVILEGES ON passboltdb.* TO 'passboltuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Passo 6: Execução das Migrações e Instalação do Passbolt

Com o ambiente configurado, execute as migrações do banco de dados e instale o Passbolt utilizando os comandos do CakePHP:

cd /var/www/passbolt
bin/cake migrations migrate
bin/cake passbolt install

O comando bin/cake passbolt install iniciará o assistente de instalação, que guiará a criação de chaves e a configuração inicial do aplicativo.

Passo 7: Configuração do Servidor Web

Configure o seu servidor web para apontar para a pasta webroot do Passbolt. A seguir, um exemplo de configuração para o Nginx:

# Exemplo de configuração Nginx para Passbolt
server {
    listen 80;
    server_name seu-dominio.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name seu-dominio.com;
    root /var/www/passbolt/webroot;
    index index.php;

    ssl_certificate /caminho/do/certificado.crt;
    ssl_certificate_key /caminho/da/chave.key;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php-fpm/www.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Passo 8: Finalização via Interface Web

Após configurar o servidor web, acesse o Passbolt através do navegador utilizando o domínio configurado (https://seu-dominio.com). Na interface, realize o healthcheck, conclua as configurações pendentes (como a geração/importação da chave GPG, configuração do SMTP e criação do primeiro usuário administrador) e finalize a instalação.

Conclusão

Com a execução dos passos descritos, o Passbolt CE estará instalado a partir do código fonte em seu ambiente de hospedagem compartilhada com AlmaLinux 9. O procedimento envolve a clonagem do repositório, configuração do ambiente via Composer, definição dos parâmetros no arquivo .env, configuração do banco de dados, execução das migrações e ajustes no servidor web.

Finalize a instalação pela interface web e proceda com a criação dos usuários conforme as necessidades da sua equipe. Para dúvidas ou suporte adicional, consulte a documentação oficial do Passbolt e os fóruns da comunidade.