Comment auto-héberger Calibre-Web sur un VPS (Guide Complet)

Calibre-Web fournit une interface web pour gérer les ebooks stockés dans Calibre. Pour les développeurs et les passionnés de homelab, auto-héberger Calibre-Web sur un serveur privé virtuel (VPS) est un moyen efficace d’accéder à votre bibliothèque d’ebooks à distance et de la gérer. Dans ce guide, nous allons passer en revue l’installation de Calibre-Web sur un VPS en utilisant Docker.

Prérequis

1. Abonnement VPS : Obtenez un VPS auprès d’un fournisseur tel que Contabo, Hetzner, DigitalOcean, Vultr, ou Linode.

2. Connaissances de base : Familiarité avec la ligne de commande et Docker.

3. Livres Calibre : Assurez-vous d’avoir votre bibliothèque Calibre prête à être intégrée.

Choisissez un Fournisseur de VPS

Pour héberger efficacement votre instance Calibre-Web, choisissez un fournisseur de VPS en fonction de votre budget et de vos besoins. Voici une brève comparaison de quelques options populaires :

Pour un équilibre entre performance et coût, Hetzner Cloud est un excellent choix. Voir notre comparaison complète de VPS pour plus d’options.

Étape 1 : Configurez Votre VPS

1. Connexion au VPS : Accédez à votre serveur via SSH.

   ssh root@your_vps_ip

2. Mettez à jour les paquets du système :

   apt update && apt upgrade -y

3. Installez Docker : Suivez le guide d’installation officiel de Docker ou utilisez :

   apt install docker.io -y
   systemctl start docker
   systemctl enable docker

Étape 2 : Installez Docker Compose

1. Téléchargez Docker Compose :

   curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   chmod +x /usr/local/bin/docker-compose

2. Vérifiez l’installation :

   docker-compose --version

Étape 3 : Configurez Calibre-Web dans Docker

1. Créez un répertoire pour Calibre-Web :

   mkdir ~/calibre-web
   cd ~/calibre-web

2. Créez un fichier docker-compose.yml : Utilisez un éditeur de texte tel que nano ou vim.

   nano docker-compose.yml

   Entrez la configuration suivante :

   version: '3'
   
   services:
     calibre-web:
       image: tecnobit/calibre-web:latest
       container_name: calibre-web
       ports:
         - "8083:8083"
       volumes:
         - ./calibredb:/calibredb
         - ./db:/calibre/db
       environment:
         - PUID=1000
         - PGID=1000

   Cela configure Calibre-Web pour fonctionner sur le port 8083, en mappant vos répertoires locaux pour un accès facile.

3. Démarrez Calibre-Web :

   docker-compose up -d

4. Accédez à Calibre-Web : Ouvrez votre navigateur web et allez à http://your_vps_ip:8083.

Étape 4 : Configuration de Calibre-Web

1. Configuration initiale : Suivez les instructions à l’écran pour configurer votre chemin de bibliothèque et d’autres paramètres.
2. Paramètres administratifs : Accédez aux paramètres administratifs pour ajuster les préférences telles que la gestion des utilisateurs et les options d’interface.

FAQ

Que dois-je faire si Docker ne démarre pas ?

Si Docker ne démarre pas, vérifiez l’état avec :

systemctl status docker

Consultez les journaux pour tout message d’erreur :

journalctl -u docker

Les problèmes courants incluent des ressources insuffisantes ou des autorisations. Assurez-vous que Docker est installé correctement et que votre utilisateur dispose des autorisations nécessaires.

Puis-je exécuter Calibre-Web sur ma machine locale au lieu d’un VPS ?

Oui, vous pouvez exécuter Calibre-Web sur votre machine locale en utilisant Docker. Les étapes seront similaires, mais vous devrez vous assurer que votre machine locale a Docker installé et configuré. Cependant, le fait de l’héberger sur un VPS offre un meilleur accès à distance et une disponibilité accrue.

Comment sauvegarder mes données Calibre-Web ?

La sauvegarde de Calibre-Web implique de préserver les données stockées dans les volumes que vous avez définis dans le fichier docker-compose.yml. Vous pouvez simplement copier les volumes vers un autre emplacement :

tar -cvzf calibre-backup.tar.gz ~/calibre-web/calibredb ~/calibre-web/db

Cette commande compresse votre base de données Calibre-Web et vos données de bibliothèque. Conservez votre sauvegarde dans un endroit sûr pour une utilisation future.

Conclusion

Auto-héberger Calibre-Web sur un VPS est un moyen efficace de gérer votre collection d’ebooks. En tirant parti de Docker, vous pouvez facilement configurer et personnaliser votre environnement en fonction de vos besoins en tant que développeur ou homelabber. Maintenant que vous avez les étapes nécessaires, vous pouvez commencer à profiter de votre bibliothèque d’ebooks auto-hébergée à tout moment et en tout lieu.