Dozzle

Accesso

• Visit the web interface: https://<IP> (replace IP with your server’s IP address)
• Accetta avviso SSL (certificato autofirmato).
• 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.

File e directory importanti

• Installazione dell'applicazione: /root/dozzle
• File Docker Compose: /root/dozzle/docker-compose.yml
• Dozzle user database: /root/dozzle/data/users.yml
• Stored credentials: /root/.cloudzy-creds

Gestione dei servizi

Elenco contenitori:

docker ps

Avviare o ripristinare i servizi:

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

Restart Dozzle:

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

Registro delle operazioni:

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

Riavvia Nginx:

systemctl restart nginx

Abilitazione SSL con un dominio

1. Indirizza il tuo dominio all'IP del server.

2. Modifica la configurazione Nginx e sostituisci entrambi server_name <IP>; con il tuo dominio (<your-domain>) sia per i blocchi HTTP (porta 80) che HTTPS (porta 443):

vim /etc/nginx/sites-available/dozzle

3. Installa Certbot:

apt install -y certbot python3-certbot-nginx

4. Run the following command to generate a valid Let’s Encrypt certificate:

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

5. Sostituire i percorsi SSL nella configurazione 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. Riavvia Nginx per applicare le modifiche:

systemctl restart nginx

7. Apri il browser e visita: https://yourdomain.com