Readeck

Accessing Readeck

1. Ouvrez votre navigateur et rendez-vous sur : 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.

Fichiers et répertoires importants

• 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
• Hôte virtuel Nginx : /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

Remarques relatives à la sécurité

• Readeck runs as a non-login system user.
• Strong systemd sandboxing is enabled.
• Only ports 80 et 443 are exposed.
• Internal service port 8000 is not accessible externally.
• TLS utilise un certificat auto-signé.

Activation du protocole SSL avec un domaine

1. Pointez votre domaine vers l'adresse IP du serveur.

2. Modifiez la configuration Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) pour les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/readeck

3. Installez Certbot :

apt install -y certbot python3-certbot-nginx

4. Exécutez la commande suivante pour générer un certificat Let’s Encrypt valide :

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

5. Remplacer les chemins SSL dans la configuration 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. Redémarrez Nginx pour appliquer les modifications :

systemctl restart nginx

7. Ouvrez votre navigateur et rendez-vous sur : https://yourdomain.com