Dozzle

Acesso

• Aceda à interface web: https://<IP> (replace IP with your server’s IP address)
• Aceitar aviso SSL (certificado autoassinado).
• Log in using credentials from /root/.cloudzy-creds

Environment & Configuration

• Admin authentication is enabled using the simple provider.
• User definitions are stored in /root/dozzle/data/users.yml
• Passwords are stored as bcrypt hashes.
• User roles: all, shell, actions, download, none (default: all).
• Docker socket is mounted read/write: /var/run/docker.sock

Adding a New User

1. Generate bcrypt user:

docker run -it --rm amir20/dozzle generate <username> 
  --password <password> --email <email> --name "<Full Name>" 
  --user-roles <roles> --user-filter "<filter>"

2. Backup users.yml:

cp /root/dozzle/data/users.yml /root/dozzle/data/users.yml.bak

3. Append only the user entry under the existing users: block in users.yml — do not repeat users.

4. Validate YAML syntax to ensure the file is correct.

Ficheiros e diretórios importantes

• Instalação da aplicação: /root/dozzle
• Ficheiro Docker Compose: /root/dozzle/docker-compose.yml
• Dozzle user database: /root/dozzle/data/users.yml
• Stored credentials: /root/.cloudzy-creds

Gestão de serviços

Listar contentores:

docker ps

Iniciar ou recriar serviços:

docker compose -f /root/dozzle/docker-compose.yml up -d

Restart Dozzle:

docker compose -f /root/dozzle/docker-compose.yml restart

Registos de acompanhamento:

docker compose -f /root/dozzle/docker-compose.yml logs -f

Reinicie o Nginx:

systemctl restart nginx

Ativar SSL com um domínio

1. Direcione o seu domínio para o IP do servidor.

2. Edite a configuração do Nginx e substitua ambos server_name <IP>; com o seu domínio (<your-domain>) para blocos HTTP (porta 80) e HTTPS (porta 443):

vim /etc/nginx/sites-available/dozzle

3. Instale o Certbot:

apt install -y certbot python3-certbot-nginx

4. Execute o seguinte comando para gerar um certificado Let’s Encrypt válido:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Substitua os caminhos SSL na configuração do Nginx:

vim /etc/apache2/sites-available/dozzle
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Reinicie o Nginx para aplicar as alterações:

systemctl restart nginx

7. Abra o seu navegador e aceda a: https://yourdomain.com