Readeck

Accessing Readeck

1. Apri il browser e visita: https://<SERVER_IP>/
2. A browser SSL warning is expected — the certificate is self-signed.
3. Create the admin account in the web interface immediately.

File e directory importanti

• Readeck data directory: /var/lib/readeck
• Readeck configuration directory: /etc/readeck
• Readeck binary: /usr/local/bin/readeck
• Systemd service file: /etc/systemd/system/readeck.service
• Nginx virtual host: /etc/nginx/sites-available/readeck
• TLS certificate and key: /etc/nginx/ssl

Managing the Services

Check Readeck status:

systemctl status readeck

Restart Readeck:

systemctl restart readeck

View Readeck logs:

journalctl -xeu readeck --no-pager -f

Nginx management:

systemctl status nginx
systemctl restart nginx
journalctl -u nginx -f

Note sulla sicurezza

• Readeck runs as a non-login system user.
• Strong systemd sandboxing is enabled.
• Only ports 80 e 443 are exposed.
• Internal service port 8000 is not accessible externally.
• TLS uses a self-signed certificate.

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/readeck

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/readeck
# 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