Foldbook Server

Dernière mise à jour : 4 novembre 2026

Foldbook Server tourne sur ton NAS, à côté de tes livres. Il les rend lisibles par les personnes que tu invites, où qu'elles soient, et ne leur montre que ce que tu leur as ouvert. Aucun port à ouvrir sur ta box : il se connecte lui-même à notre relais.

Laisse ton IA t’aider

Copie ce texte et colle-le dans ChatGPT, Claude ou Gemini. Il contient tout ce qu’il faut savoir : l’assistant te pose quelques questions sur ton NAS, puis t’explique chaque étape. S’il a accès à un terminal, il peut même faire l’installation à ta place.

Tu vas m'aider à installer Foldbook Server, pas à pas. Commence par me poser les questions utiles, une à la fois, puis guide-moi. Si tu as accès à un terminal sur la machine concernée, tu peux faire l'installation toi-même : montre-moi chaque commande avant de la lancer.

## Ce qu'est Foldbook Server
- Foldbook est une app Android, iPhone et iPad qui lit des BD, des mangas, des comics et des livres (CBZ, CBR, CB7, PDF, EPUB). Site : https://foldbook.app
- Foldbook Server est un conteneur Docker qui tourne sur le NAS (ou un ordinateur toujours allumé), à côté des livres. Il permet de prêter sa bibliothèque à des proches, qui la lisent depuis chez eux, en 4G ou au bureau, avec leur propre compte Foldbook.
- Il se connecte lui-même au relais de Foldbook (wss://relay.foldbook.app) par une connexion sortante : aucun port à ouvrir sur la box, aucune redirection à régler.
- Il lit les livres en lecture seule et ne modifie jamais les fichiers. Rien n'est prêté tant que le propriétaire n'a pas coché, dans l'app, les dossiers qu'il prête. Le relais transmet les pages sans les garder.

## L'image et ses réglages
- Image : ghcr.io/milrer/foldbook-server:latest (Intel x86_64 et ARM64), publique.
- Volume /library (en lecture seule, :ro) : le dossier qui contient les dossiers de livres. Chacun de ses sous-dossiers (par exemple Mangas, BD, Livres) peut devenir une bibliothèque prêtée. Les dossiers sans livres (films, téléchargements) ne sont jamais prêtés par défaut.
- Volume /data : l'identité du serveur (server.json). À garder : le supprimer oblige à refaire l'association.
- Port 8686 : la page d'état locale, qui affiche le code d'association à 6 chiffres.
- Variable facultative SERVER_NAME : le nom proposé à l'association (par exemple le nom du NAS).

Fichier compose de référence (chemins d'un Synology, à adapter) :

services:
  foldbook:
    image: ghcr.io/milrer/foldbook-server:latest
    container_name: foldbook-server
    restart: unless-stopped
    ports:
      - "8686:8686"
    environment:
      - SERVER_NAME=MonNAS
    volumes:
      - /volume1/Media:/library:ro
      - /volume1/docker/foldbook:/data

## Les questions à me poser d'abord
1. Sur quoi l'installer : Synology (quelle version de DSM ?), QNAP, Unraid, TrueNAS, un Raspberry Pi, un Mac ou un PC ?
2. Docker (ou Container Manager sur Synology, Container Station sur QNAP) est-il déjà installé ?
3. Où sont mes livres : le chemin exact du dossier qui contient mes dossiers de BD, mangas ou livres ?
4. As-tu accès à un terminal sur cette machine, ou dois-tu me guider dans l'interface ?

## Les étapes selon la machine
- Synology (DSM 7.2 et plus) : installer Container Manager depuis le Centre de paquets. Dans File Station, créer le dossier docker/foldbook. Dans Container Manager › Projet › Créer : nom foldbook-server, chemin /docker/foldbook (pas le dossier des livres), source « Créer un fichier docker-compose.yml », coller le fichier, laisser « portail Web » décoché, puis Terminé.
- QNAP : Container Station › Applications › Créer, coller le fichier en adaptant les chemins (/share/…).
- Unraid : plugin Docker Compose Manager, ou un conteneur ajouté à la main avec les mêmes volumes et le port 8686.
- Linux, Raspberry Pi, Mac ou PC avec Docker : créer un dossier, y écrire le fichier sous le nom compose.yaml en adaptant les chemins, puis lancer « docker compose up -d » dans ce dossier.

## Vérifier
- Ouvrir http://ADRESSE-DE-LA-MACHINE:8686 dans un navigateur. La page « Foldbook Server » doit afficher un code à 6 chiffres et « relais connecté ».
- L'adresse locale se trouve dans les réglages réseau du NAS, dans l'interface de la box, ou avec « ip addr » / « ipconfig ».

## Associer dans l'app
1. Dans Foldbook, se connecter à son compte (Réglages › Compte).
2. Réglages › Bibliothèque partagée › Associer mon serveur, saisir le code (il change toutes les 30 minutes).
3. « Partage lu par le serveur » : le nom du dossier partagé monté sur /library (Media pour /volume1/Media). Facultatif, il sert à masquer des titres depuis ses propres bibliothèques.
4. Cocher les dossiers à prêter, puis inviter des personnes : chacune reçoit un code de 8 caractères à saisir dans Réglages › Bibliothèque partagée › J'ai reçu une invitation.

## Dépannage
- La page :8686 ne s'ouvre pas : vérifier que le conteneur tourne et consulter son journal. Si le port 8686 est déjà pris, mapper un autre port côté machine, par exemple "8687:8686".
- « relais hors ligne » : la machine doit pouvoir sortir sur Internet (HTTPS, port 443) et résoudre relay.foldbook.app.
- Aucun dossier proposé ou dossiers vides : le chemin monté sur /library est faux, ou le conteneur n'a pas le droit de le lire.
- Code expiré : recharger la page :8686.
- Mise à jour : il faut que la nouvelle image soit téléchargée. Sur Synology, « Créer » seul réutilise l'ancienne image restée sur le NAS : arrêter le projet, Projet › Action › Nettoyer, supprimer l'image ghcr.io/milrer/foldbook-server dans Image, puis Projet › clic droit › Créer. Ailleurs : docker compose pull, puis docker compose up -d. La page du port 8686 affiche ensuite la nouvelle version. L'association, les dossiers prêtés et les invités sont gardés tant que /data est conservé.

Aide : https://foldbook.app/aide · contact : hello@believemy.com

1. Installer le conteneur

Sur un Synology, ouvre Container Manager › Projet › Créer, choisis un dossier (par exemple /volume1/docker/foldbook) et colle ce fichier. Remplace /volume1/Media par le dossier qui contient tes BD, mangas et livres. Il est monté en lecture seule : Foldbook Server ne modifie jamais tes fichiers.

services:
  foldbook:
    image: ghcr.io/milrer/foldbook-server:latest
    container_name: foldbook-server
    restart: unless-stopped
    ports:
      - "8686:8686"
    volumes:
      - /volume1/Media:/library:ro
      - /volume1/docker/foldbook:/data

2. L’associer à ton compte

Ouvre http://adresse-de-ton-nas:8686 dans un navigateur. La page affiche un code à six chiffres. Dans Foldbook, touche Réglages › Bibliothèque partagée › Associer un serveur, puis saisis ce code. Dans « Partage lu par le serveur », indique le dossier partagé que tu as monté (Media pour /volume1/Media) : c'est ce qui te permet de masquer des titres directement depuis tes bibliothèques. Il faut un compte Foldbook. Coche ensuite les dossiers que tu prêtes : ceux qui contiennent des livres sont déjà cochés, et rien n’est prêté avant que tu valides.

3. Inviter tes proches

Dans Réglages › Bibliothèque partagée, touche ton serveur puis « Inviter ». Envoie le lien ou le code à la personne : elle l'ouvre dans Foldbook, avec son propre compte. Tu choisis ensuite ses bibliothèques et les titres à lui masquer.

Masquer des titres

Dans la bibliothèque, garde le doigt sur une couverture pour passer en sélection, puis touche ou glisse sur d'autres séries. « Masquer pour… » propose les personnes invitées. Le serveur refuse ensuite ces livres à la personne, même si elle connaît leur chemin.

Sans Docker

Sur un Mac ou un PC, Docker Desktop fait l'affaire avec le même fichier. Remplace les chemins par ceux de ton dossier de livres et d'un dossier pour les réglages.

Mettre à jour Foldbook Server

Quand une nouvelle version sort, Foldbook te le dit : la fiche de ton serveur affiche « Mise à jour disponible », avec ce qui change. La mise à jour prend deux minutes.

Attention : « Créer » ne suffit pas. Container Manager garde l’ancienne image sur le NAS et la réutilise. Si tu arrêtes le projet puis le recrées, tu repars sur la même version. Il faut d’abord supprimer l’image : c’est ce qui l’oblige à télécharger la nouvelle.

Sur un Synology, dans Container Manager

Arrêter le projetProjet › foldbook-server › Arrêter.
Nettoyer le projetProjet › foldbook-server › Action › Nettoyer. Le conteneur arrêté est supprimé, le projet et son fichier restent. Sans cette étape, l’image est encore marquée « utilisée » et refuse d’être supprimée.
Supprimer l’imageImage › ghcr.io/milrer/foldbook-server › Supprimer. Son point est maintenant gris.
Recréer le projetProjet › foldbook-server › clic droit › Créer. L’image n’étant plus sur le NAS, Container Manager télécharge la dernière version, puis démarre le serveur.

Pour vérifier : la page http://adresse-de-ton-nas:8686 affiche le nouveau numéro de version, et dans Foldbook, l’encadré « Mise à jour disponible » a disparu.

Rien n’est à refaire dans l’app : l’association, les dossiers prêtés et les invités sont gardés. Ils vivent dans le dossier /data et dans ton compte, pas dans l’image.

Ailleurs qu’un Synology, dans le dossier du fichier compose :

docker compose pull
docker compose up -d