PufferPanel

Accessing PufferPanel

Abra o seu navegador e visite: https://<SERVER_IP>

É esperado um aviso de SSL no browser (certificado auto-assinado).

Run the following command on the server to create your first user. Be sure to enter “Y” when it asks if this is an admin so you can fully use your panel.

pufferpanel user add

Log in with your admin account.

Navigate to Settings and configure:

• Master URL (e.g., https://<SERVER_IP>)
• Control user registration
• Email setup (optional)

Ports

• Web UI: 8080
• SFTP: 5657

Ficheiros e diretórios importantes

• Panel configuration: /etc/pufferpanel/config.json
• Panel logs: /var/log/pufferpanel
• Web root (nginx): /var/www/pufferpanel
• SSL Certificates: /etc/nginx/ssl/pufferpanel.crt & /etc/nginx/ssl/pufferpanel.key

Gestão de serviços

PufferPanel:

systemctl start pufferpanel
systemctl stop pufferpanel
systemctl restart pufferpanel
systemctl status pufferpanel

Nginx:

systemctl start nginx
systemctl stop nginx
systemctl restart nginx
systemctl reload nginx
systemctl status 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/pufferpanel.conf

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/nginx/sites-available/pufferpanel.conf
# Before:
    # ssl_certificate     /etc/nginx/ssl/pufferpanel.crt;
    # ssl_certificate_key /etc/nginx/ssl/pufferpanel.key;
# 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. Set Master URL in web UI Settings to https://yourdomain.com

8. Open your browser and visit: https://yourdomain.com

Notas

• Nginx is configured to redirect HTTP → HTTPS automatically.
• SSL is self-signed. For production, consider using Let’s Encrypt / Certbot.
• Docker is installed and the pufferpanel user is added to the Docker group.