Files
wiki/Catalogue-Self-Hosted/apps/app-readeck.md
T
2026-06-09 18:40:21 +02:00

5.2 KiB


title: Readeck created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, bookmarks, read-later, go, ebook, epub, kobo, progress-tracking, oauth2] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Bookmarks, https://readeck.org, https://github.com/readeck/readeck]

📖 Readeck

Le read-it-later moderne en Go : EPUB natif pour Kobo/Kindle, suivi de progression, OAuth2, et une UI soignée. Le successeur spirituel de Wallabag pour une nouvelle génération.

📋 Informations Générales

Champ Valeur
Site web readeck.org
GitHub readeck/readeck
Licence AGPL-3.0
Langage Go
Étoiles GitHub 880
Dernière MAJ 2026-05-25
Catégorie cat-bookmarks

📝 Description

Readeck est un projet open-source de read-it-later moderne, écrit en Go, dont l'objectif affiché est de devenir "le Wallabag killer". Pensé à l'origine comme un fork spirituel, le projet a pris ses propres décisions techniques : pas de Symfony, pas de PHP, juste un binaire Go rapide avec une UI Svelte réactive.

Ce qui distingue Readeck :

  • 📕 Export EPUB / KEPUB de qualité, sync native avec Kobo (et Kindle via Calibre)
  • 📊 Suivi de progression : pourcentage lu, position de scroll, temps estimé
  • 🔐 OAuth2 natif (créez d'autres apps sur votre instance)
  • 🏷️ Étiquettes, collections, labels avec couleurs
  • 🔌 API REST documentée + extensions navigateur + bookmarklet
  • 📥 Import depuis Wallabag, Pocket, Pinboard
  • 🌓 UI dark/light, rapide, single-page

Readeck vise un public qui veut lire (et non seulement archiver) : intégration Kobo, EPUB soigné, progression sync. Pour un homelab, c'est l'option la plus moderne en Go pur, sans dépendance exotique. La base SQLite par défaut simplifie énormément les sauvegardes.

⚠️ Le projet est plus jeune que Wallabag : la communauté est encore en formation, certains importers sont en bêta. C'est le compromis modernité vs maturité.

🚀 Installation

Option 1 : Docker Compose (recommandé)

# docker-compose.yml
services:
  readeck:
    image: ghcr.io/readeck/readeck:latest
    container_name: readeck
    restart: unless-stopped
    ports:
      - "8484:8080"
    environment:
      - READECK_DATABASE=sqlite:///data/readeck.db
      - READECK_DATA_DIR=/data
      - READECK_HOST=0.0.0.0
      - READECK_PORT=8080
      - READECK_BASE_URL=http:/...84
      - READECK_SMTP_HOST=smtp.example.com
      - READECK_SMTP_PORT=587
      - READECK_SMTP_USER=no-reply@example.com
      - READECK_SMTP_PASSWORD=***      - READECK_SMTP_FROM=no-reply@example.com
    volumes:
      - readeck-data:/data

volumes:
  readeck-data:

Option 2 : Binaire unique

wget https://github.com/readeck/readeck/releases/latest/download/readeck_Linux_x86_64.tar.gz
tar -xzf readeck_Linux_x86_64.tar.gz
sudo mv readeck /usr/local/bin/

# Service systemd minimal
cat > /etc/systemd/system/readeck.service <<EOF
[Unit]
Description=Readeck
After=network.target

[Service]
ExecStart=/usr/local/bin/readeck -host 0.0.0.0 -port 8080
WorkingDirectory=/var/lib/readeck
Restart=always
User=readeck

[Install]
WantedBy=multi-user.target
EOF

⚙️ Configuration Initiale

  1. Créer le premier utilisateur via readeck user add admin puis suivre l'UI.
  2. Changer le mot de passe immédiatement.
  3. Activer OAuth2 : créer un client depuis l'admin pour brancher des apps tierces.
  4. Configurer SMTP pour les exports EPUB par email et la récupération de mot de passe.
  5. Activer le partage Kobo : URL /kobo/{user_id} à entrer dans la liseuse.
  6. Brancher un reverse proxy HTTPS (Caddy/Traefik) pour usage public.
  7. Importer depuis Wallabag, Pocket, Pinboard ou un fichier HTML.

🔄 Alternatives

Open Source

Propriétaires (ce que Readeck remplace)

  • Pocket — Sunset 2025
  • Instapaper — Cloud-only
  • Readwise Reader — Freemium, Evernote-like
  • Matter — Fermé
  • Amazon Kindle Highlights — Lock-in propriétaire

🔐 Sécurité

  • Authentification par session sécurisée (cookies HttpOnly, SameSite)
  • OAuth2 pour clients tiers
  • Pas de télémétrie par défaut
  • À placer derrière HTTPS (Traefik/Caddy)
  • Le binaire Go a une surface d'attaque très réduite
  • Sauvegarder simplement le volume readeck-data (SQLite + fichiers)

📚 Ressources

Pages Liées