Karakeep self-hosted : sauvegarde bookmarks et liens — tutoriel 2026

Introduction

Combien de fois avez-vous sauvegardé un lien dans un onglet ouvert depuis trois semaines, dans un carnet Telegram envoyé à vous-même, ou dans un dossier de favoris navigateur qui ressemble aujourd’hui à un débarras numérique ? La gestion des liens est un problème universel, mais il devient particulièrement critique dès que vous travaillez dans un contexte de veille professionnelle intense : suivi des textes réglementaires OHADA, jurisprudence fiscale, circulaires BCEAO, publications techniques internationales, documentation de frameworks open source. Perdre un lien, c’est parfois perdre des heures de recherche.

Karakeep — rebaptisé ainsi depuis sa première vie sous le nom Hoarder — est un gestionnaire de bookmarks entièrement self-hostable, conçu pour les personnes qui accumulent de l’information et veulent la retrouver. Il ne se contente pas de stocker des URLs : il récupère automatiquement le titre, la description et une capture visuelle de chaque page sauvegardée, génère des tags par intelligence artificielle (via OpenAI ou, mieux, via Ollama en local), indexe le contenu complet dans Meilisearch pour une recherche instantanée, et synchronise tout cela avec des extensions navigateur pour Firefox et Chrome ainsi que des apps mobiles iOS et Android.

Face aux alternatives populaires comme Raindrop.io (cloud propriétaire, abonnement payant pour les fonctions avancées), Linkding (minimaliste, sans IA) ou Wallabag (orienté lecture hors-ligne plutôt qu’organisation), Karakeep occupe un créneau précis : la gestion intelligente d’une bibliothèque de liens volumineuse, avec une prise en main rapide et un déploiement Docker en moins de 25 minutes. C’est l’outil de ce tutoriel.

Prérequis

Avant de commencer, assurez-vous que votre environnement dispose des éléments suivants. L’installation complète prend environ 25 minutes sur une connexion correcte.

• Docker Engine 24+ et Docker Compose v2+ installés sur votre hôte Linux (Ubuntu 22.04 LTS ou Debian 12 recommandés). Sur un VPS Hetzner, DigitalOcean ou OVH, une ligne apt install docker.io docker-compose-plugin suffit.
• 1 Go de RAM disponible minimum — Karakeep fait tourner trois services (l’application web, le worker de traitement et Meilisearch) ; en pratique 2 Go sont plus confortables si vous activez aussi Ollama sur la même machine.
• 10 Go d’espace disque pour les données, captures de pages et index Meilisearch. Prévoir plus si vous comptez archiver des PDFs.
• Ollama (optionnel mais recommandé) pour le tagging automatique en local, sans envoyer vos liens à OpenAI. Ollama tourne séparément et expose une API HTTP locale que Karakeep consomme.
• Un nom de domaine ou une IP fixe si vous souhaitez accéder à Karakeep depuis l’extérieur du serveur. Un reverse proxy Nginx ou Caddy est utile mais non obligatoire pour un usage interne.
• Niveau requis : intermédiaire — vous savez éditer un fichier texte en ligne de commande, lancer un docker compose up et lire des logs.

Étape 1 — Karakeep vs Linkding vs Wallabag : choisir le bon outil

Avant de déployer, il est utile de comprendre pourquoi choisir Karakeep plutôt qu’un autre gestionnaire de bookmarks self-hosted. Les trois outils les plus comparés sont Karakeep, Linkding et Wallabag, et chacun répond à un besoin différent.

Linkding est le plus minimaliste des trois. Développé en Python/Django, il est ultra-léger (moins de 100 Mo RAM), propose un import/export Netscape HTML, des tags manuels, et une API REST simple. Il est parfait si vous voulez juste un pense-bête de liens sans IA ni recherche avancée. Ce qu’il ne fait pas : générer des tags automatiquement, capturer le contenu des pages pour une lecture hors-ligne, ou indexer le texte complet des articles liés.

Wallabag est orienté read-it-later : son moteur extrait le contenu lisible d’un article (comme Pocket ou Instapaper) pour vous permettre de le lire confortablement, même hors ligne. Il a 13 ans d’existence, une communauté solide, et un focus sur la lecture plutôt que sur l’organisation. Si votre usage principal est de sauvegarder des articles longs pour les lire le soir sur mobile, Wallabag est excellent. Mais pour une base de connaissance structurée avec recherche full-text sur des milliers de liens, il commence à montrer ses limites.

Karakeep cible les utilisateurs qui accumulent des volumes importants de liens, de notes et de fichiers, et qui ont besoin de les retrouver rapidement sans les avoir classés manuellement à l’avance. Ses atouts distinctifs sont le tagging automatique par IA (vous sauvegardez, l’IA classe), la recherche full-text alimentée par Meilisearch (vous retrouvez un lien en cherchant un mot du contenu de la page, pas seulement du titre), la capture de screenshots et de contenu pour archiver les pages qui disparaissent, et un écosystème d’applications bien finies (extension navigateur, apps mobiles, API). Avec 22 797 étoiles GitHub en avril 2026, c’est devenu le projet de référence de la catégorie.

En résumé : Linkding si vous voulez du simple et du léger, Wallabag si vous lisez des articles longs hors-ligne, Karakeep si vous gérez une base de veille volumineuse et voulez de l’IA pour vous aider à vous y retrouver.

Étape 2 — Déployer Karakeep via Docker Compose

L’installation recommandée par la documentation officielle de Karakeep passe par Docker Compose. Le fichier de configuration orchestre trois services : l’application web (Next.js), le worker de traitement en arrière-plan (qui récupère les métadonnées des liens et appelle l’IA pour les tags), et Meilisearch (le moteur de recherche). Ces trois services communiquent via un réseau Docker interne ; vous n’exposez au monde extérieur que le port de l’application web.

Commencez par créer un répertoire de travail dédié :

mkdir -p ~/karakeep && cd ~/karakeep

Créez ensuite le fichier docker-compose.yml avec le contenu suivant. Ce fichier est basé sur le fichier officiel du dépôt GitHub de Karakeep :

version: "3.8"
services:
  web:
    image: ghcr.io/karakeep-app/karakeep/web:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    ports:
      - 3000:3000
    volumes:
      - karakeep_data:/data
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      DATA_DIR: /data

  workers:
    image: ghcr.io/karakeep-app/karakeep/workers:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    volumes:
      - karakeep_data:/data
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      DATA_DIR: /data
    depends_on:
      - web

  chrome:
    image: gcr.io/zenika-hub/alpine-chrome:123
    restart: unless-stopped
    command:
      - --no-sandbox
      - --disable-gpu
      - --disable-dev-shm-usage
      - --remote-debugging-address=0.0.0.0
      - --remote-debugging-port=9222
      - --hide-scrollbars

  meilisearch:
    image: getmeili/meilisearch:v1.11.1
    restart: unless-stopped
    volumes:
      - meilisearch_data:/meili_data
    environment:
      MEILI_MASTER_KEY: ${MEILI_MASTER_KEY}
      MEILI_NO_ANALYTICS: "true"

volumes:
  karakeep_data:
  meilisearch_data:

Ce fichier déclare également un service chrome : Karakeep utilise un navigateur headless (Chromium sans interface graphique) pour capturer les screenshots des pages que vous sauvegardez et pour extraire leur contenu textuel. C’est ce service qui rend possible l’archivage de pages entières, pas seulement l’URL.

Créez maintenant le fichier .env dans le même répertoire. Ce fichier contient vos secrets — ne le commitez jamais dans un dépôt Git :

# Version de Karakeep à utiliser
KARAKEEP_VERSION=release

# Clé secrète pour NextAuth (authentification)
# Générez avec : openssl rand -base64 36
NEXTAUTH_SECRET=REMPLACEZ_PAR_UNE_CHAINE_ALEATOIRE_LONGUE

# URL d'accès à l'application (adaptez à votre IP ou domaine)
NEXTAUTH_URL=http://localhost:3000

# Clé maître Meilisearch
# Générez avec : openssl rand -base64 36
MEILI_MASTER_KEY=REMPLACEZ_PAR_UNE_AUTRE_CHAINE_ALEATOIRE

Pour générer les deux valeurs aléatoires requises, exécutez deux fois la commande suivante et copiez chaque résultat dans le fichier .env :

openssl rand -base64 36

Une fois le fichier .env complété avec vos vraies valeurs, lancez l’ensemble des services :

docker compose up -d

Docker va télécharger les images (environ 600 Mo au total) et démarrer les quatre conteneurs. Après une à deux minutes, visitez http://localhost:3000 (ou l’IP de votre serveur si vous déployez sur un VPS distant) : la page de connexion de Karakeep doit s’afficher. Si vous voyez une erreur de connexion à Meilisearch dans les logs (docker compose logs web), attendez encore 30 secondes — Meilisearch peut prendre un peu de temps à s’initialiser au premier démarrage.

Étape 3 — Premier compte et import de vos favoris HTML

Au premier accès, Karakeep vous propose de créer un compte administrateur. Renseignez une adresse e-mail et un mot de passe solide : ce compte sera le propriétaire de toute votre base de bookmarks. Karakeep supporte la création de plusieurs comptes utilisateurs, ce qui est pratique pour une équipe de veille partagée.

Une fois connecté, vous découvrez l’interface : un tableau de bord listant vos bookmarks, un panneau latéral avec vos listes et tags, et un champ de recherche en haut. Pour l’instant, tout est vide. Importons vos favoris existants.

Karakeep supporte l’import depuis trois sources :

• Format Netscape HTML — le format universel exporté par Firefox, Chrome, Edge et Safari depuis le gestionnaire de favoris. C’est le format le plus courant pour migrer depuis un navigateur.
• CSV Pocket — si vous migrez depuis l’application Pocket de Mozilla.
• JSON Omnivore — pour les utilisateurs de l’application Omnivore (read-it-later open source).

Pour exporter vos favoris Firefox en HTML, allez dans Marque-pages → Afficher tous les marque-pages → Import et sauvegarde → Exporter les marque-pages en HTML. Pour Chrome, Favoris → Gestionnaire de favoris → icône ⋮ → Exporter les favoris. Vous obtenez un fichier bookmarks.html.

Dans Karakeep, cliquez sur l’icône de votre profil (en haut à droite), puis Paramètres → Import. Sélectionnez le fichier HTML exporté et lancez l’import. Karakeep va créer un bookmark pour chaque lien présent dans le fichier, en conservant les titres et les tags/dossiers d’origine. Le worker en arrière-plan va ensuite traiter chaque lien un par un : récupérer la description, faire une capture de la page, et si vous avez configuré l’IA, générer des tags. Ce traitement peut prendre plusieurs minutes si vous importez des centaines de liens — c’est normal et se fait entièrement en arrière-plan.

Étape 4 — Tagging automatique via Ollama

Le tagging automatique est l’une des fonctionnalités les plus puissantes de Karakeep. Plutôt que de classer manuellement chaque lien sauvegardé, vous laissez un modèle de langage analyser le titre et le contenu de la page pour lui attribuer des tags pertinents. Karakeep supporte deux modes : OpenAI (clé API nécessaire, envoi des données à des serveurs tiers) et Ollama (modèle local, vos données restent sur votre serveur). Pour un usage professionnel et confidentiel, Ollama est évidemment préférable.

Ollama doit être installé sur votre hôte ou sur un serveur accessible depuis votre instance Karakeep. Si Ollama tourne sur la même machine que Docker, son URL depuis l’intérieur du réseau Docker sera http://host-gateway:11434 sous Linux (la passerelle vers l’hôte). Installez d’abord Ollama et téléchargez un modèle léger comme mistral (7B paramètres, environ 4 Go) :

# Installation d'Ollama sur l'hôte
curl -fsSL https://ollama.com/install.sh | sh

# Téléchargement du modèle de texte
ollama pull mistral

# Optionnel : modèle de vision pour taguer les images
ollama pull llava

Une fois Ollama opérationnel, ajoutez les variables suivantes dans votre fichier .env et relancez Docker Compose :

# URL de l'API Ollama (depuis l'intérieur du réseau Docker)
OLLAMA_BASE_URL=http://host-gateway:11434

# Modèle pour l'analyse de texte
INFERENCE_TEXT_MODEL=mistral

# Modèle pour l'analyse d'images (optionnel)
INFERENCE_IMAGE_MODEL=llava

Après avoir modifié le .env, relancez les services pour que les nouvelles variables soient prises en compte :

docker compose up -d

Désormais, chaque nouveau bookmark ajouté sera automatiquement analysé par Mistral, qui proposera des tags appropriés. Par exemple, un lien vers un article sur la fiscalité des PME au Sénégal recevra automatiquement des tags comme fiscalité, pme, sénégal, droit-des-affaires — sans aucune intervention manuelle. Les tags suggérés par l’IA apparaissent dans l’interface avec un indicateur visuel ; vous pouvez les accepter, les modifier ou en ajouter d’autres manuellement.

Notez que si votre machine dispose de moins de 8 Go de RAM totale, le modèle Mistral 7B peut surcharger le système. Dans ce cas, optez pour phi3:mini (3.8B paramètres, environ 2.3 Go) qui donne des résultats acceptables pour le tagging tout en étant nettement plus léger.

Étape 5 — Recherche full-text dans vos bookmarks

La recherche full-text est ce qui différencie vraiment Karakeep d’un simple gestionnaire de favoris. Meilisearch, le moteur de recherche embarqué, indexe non pas seulement les titres et URLs de vos bookmarks, mais également le contenu textuel extrait des pages par le navigateur headless Chromium. Cela signifie que si vous avez sauvegardé un article contenant le terme « article 116 du Code général des impôts sénégalais », vous pouvez retrouver ce bookmark en cherchant simplement « article 116 » ou « CGI sénégalais » dans la barre de recherche de Karakeep — même si ces mots n’apparaissent pas dans le titre de l’article.

La recherche dans Karakeep supporte plusieurs syntaxes utiles. Une recherche simple sur un ou plusieurs mots retourne les bookmarks dont le contenu, le titre ou les tags contiennent ces mots. Vous pouvez filtrer par tag avec la syntaxe #tag dans la barre de recherche : taper #ohada contrat retournera tous vos bookmarks taggués ohada dont le contenu mentionne le mot contrat. Vous pouvez également filtrer par liste (les équivalents de dossiers dans Karakeep) ou par type de bookmark (lien, note, image).

Meilisearch étant un moteur de recherche conçu pour la rapidité, même sur des bases de plusieurs milliers de bookmarks, les résultats s’affichent en temps réel pendant que vous tapez. La pertinence est calculée en tenant compte de la fréquence des termes, de leur position dans le document et des termes exacts versus approximatifs. Pour une équipe de veille qui accumule des centaines de liens par mois, cette recherche instantanée change fondamentalement la façon de travailler : on sauvegarde en masse et on retrouve à la demande, sans jamais avoir besoin de classer parfaitement au moment de la sauvegarde.

Étape 6 — Extension navigateur Firefox et Chrome

L’extension navigateur est le point d’entrée principal pour alimenter Karakeep au quotidien. Sans elle, vous devrez copier-coller des URLs dans l’interface web à chaque fois que vous voulez sauvegarder un lien — ce qui est beaucoup trop fastidieux pour en faire une habitude. L’extension réduit l’action à un seul clic.

Pour Firefox, l’extension Karakeep est disponible sur le catalogue officiel Mozilla Add-ons à l’adresse addons.mozilla.org/en-US/firefox/addon/karakeep/. Elle est à jour en version 1.2.9 (février 2026). Installez-la, puis ouvrez ses options : vous devrez renseigner l’URL de votre instance Karakeep (par exemple http://votre-serveur:3000 ou votre domaine personnalisé) et vous authentifier avec les identifiants de votre compte Karakeep. Une fois configurée, un clic sur l’icône Karakeep dans la barre d’outils ouvre un panneau latéral qui vous permet de sauvegarder la page courante, de lui ajouter des tags manuels, de choisir une liste de destination, et d’ajouter une note personnelle — le tout sans quitter la page que vous lisez.

Pour Chrome (et les navigateurs basés sur Chromium comme Brave ou Edge), cherchez « Karakeep » dans le Chrome Web Store. La procédure de configuration est identique à Firefox. Si votre entreprise gère des navigateurs via des politiques de groupe et que vous ne pouvez pas installer d’extensions depuis le Web Store, Karakeep peut également être ajouté manuellement en mode développeur à partir des sources disponibles sur GitHub.

Une fonctionnalité particulièrement utile de l’extension est la sauvegarde rapide en arrière-plan : vous pouvez choisir de sauvegarder une page directement sans ouvrir le panneau, avec les tags Ollama générés automatiquement après coup. Cela permet de capturer des dizaines de liens en quelques secondes pendant une session de recherche intensive, et de les tagger et organiser ultérieurement.

Étape 7 — Application mobile et synchronisation multi-appareils

Karakeep dispose d’applications natives pour iOS et Android, téléchargeables depuis les stores officiels (recherchez « Karakeep » sur l’App Store ou le Google Play Store). Ces applications se connectent à votre instance self-hosted exactement comme l’extension navigateur : vous renseignez l’URL de votre serveur et vos identifiants. Il n’y a pas de compte cloud obligatoire — toutes les données restent sur votre serveur.

L’application mobile remplit deux usages principaux. D’abord, la sauvegarde depuis mobile : la fonction « partager vers Karakeep » s’intègre au menu de partage natif d’iOS et Android, ce qui vous permet d’envoyer n’importe quel lien ouvert dans Safari, Chrome mobile, ou toute autre application vers votre bibliothèque Karakeep d’un seul geste. Ensuite, la consultation : l’application affiche votre bibliothèque complète, supporte la recherche full-text (les requêtes sont envoyées à votre serveur Meilisearch), et permet de naviguer par tags ou listes. Pour les équipes dont certains membres travaillent principalement depuis leur smartphone — ce qui est courant en Afrique de l’Ouest — cette application mobile est indispensable pour que Karakeep devienne réellement l’outil central de la veille collective.

La synchronisation entre l’extension navigateur desktop, l’application mobile et l’interface web est instantanée et transparente : tout nouveau bookmark ajouté depuis n’importe quel canal apparaît immédiatement partout, car toutes les applications lisent et écrivent sur la même base de données hébergée sur votre serveur. Il n’y a pas de couche de synchronisation externe à gérer.

Erreurs fréquentes

Adaptation au contexte ouest-africain

Karakeep est un outil particulièrement adapté aux équipes de recherche et de veille opérant en Afrique de l’Ouest francophone, pour plusieurs raisons concrètes liées aux spécificités du contexte local.

La première est l’archivage des sources réglementaires et métier. Le droit des affaires en Afrique de l’Ouest est régi par un ensemble de textes produits par des institutions multiples : l’OHADA (Organisation pour l’Harmonisation en Afrique du Droit des Affaires) publie ses Actes Uniformes sur ohada.com, la BCEAO publie ses circulaires et instructions sur bceao.int, les directions générales des impôts nationales maintiennent des sites parfois fragiles qui disparaissent ou changent d’URL sans préavis. Karakeep vous permet d’archiver non seulement l’URL de ces textes, mais également leur contenu complet grâce à la capture par Chromium headless. Quand une page réglementaire est retirée ou modifiée, vous disposez toujours d’une copie locale horodatée. Pour un cabinet juridique, un service financier ou une direction administrative, c’est une sécurité documentaire considérable.

La deuxième raison est la recherche offline. Dans de nombreuses villes de la région, la connexion internet est intermittente : pannes de courant, coupures réseau, dégradation de la bande passante aux heures de pointe. Karakeep, une fois déployé sur un serveur local ou un NAS de bureau, fonctionne entièrement en réseau local. Toute l’équipe peut continuer à consulter, rechercher et annoter ses bookmarks même sans accès internet, car Meilisearch et la base de données tournent en local. Les liens sauvegardés dont le contenu a été archivé restent consultables même si le site source est inaccessible.

La troisième raison est la structuration du travail d’équipe de veille. Karakeep supporte plusieurs comptes utilisateurs sur la même instance. Une équipe de cinq ou dix chargés de veille peut travailler sur la même bibliothèque partagée, chacun contribuant des liens depuis son navigateur ou son mobile. Les listes permettent d’organiser les sources par thématique (droit fiscal, droit social, financement PME, appels d’offres, jurisprudence CCJA) et de les partager entre membres de l’équipe. Pour les PME qui n’ont pas les moyens d’un outil de veille professionnel comme Factiva ou Europresse, Karakeep offre une infrastructure de veille structurée pour un coût essentiellement limité à un VPS à 5-10 euros par mois.

Enfin, côté infrastructure, les VPS accessibles depuis l’Afrique de l’Ouest ne manquent pas à des tarifs raisonnables : Hetzner (Allemagne/Finlande), OVH (Roubaix ou Gravelines avec bonne latence vers l’Afrique), et des acteurs régionaux comme Isocel (Bénin), Arc Télécom (Sénégal) ou Côte d’Ivoire Télécom proposent des offres hébergement. Pour une instance Karakeep d’équipe, un VPS à 2 vCPU / 4 Go RAM est suffisant pour 5-10 utilisateurs avec Ollama activé.

Tutoriels frères

Cet article fait partie du cluster Plateforme médias self-hosted PME francophone. Les tutoriels suivants du même cluster approfondissent des outils complémentaires :

• Jellyfin self-hosted : votre médiathèque privée — tutoriel 2026 — déployez votre propre Netflix avec vos fichiers vidéo locaux, accessible depuis n’importe quel navigateur ou application mobile.
• Immich self-hosted : sauvegardez et organisez vos photos — tutoriel 2026 — alternative Google Photos entièrement privée, avec reconnaissance faciale et recherche par objet via IA locale.
• PeerTube self-hosted : hébergez vos vidéos en toute autonomie — tutoriel 2026 — plateforme de diffusion vidéo self-hosted, idéale pour les formations et conférences internes.

Pour aller plus loin

L’écosystème Karakeep est actif et bien documenté. Voici les ressources primaires à consulter :

• Site officiel : karakeep.app — présentation des fonctionnalités, téléchargement des apps mobiles, accès à la version cloud gérée si vous ne souhaitez pas héberger vous-même.
• Documentation officielle : docs.karakeep.app — installation, configuration des variables d’environnement, guide d’administration, référence API REST complète.
• Dépôt GitHub : github.com/karakeep-app/karakeep — code source, issues, releases, fichiers Docker officiels.
• Guide de migration Hoarder → Karakeep : docs.karakeep.app/administration/hoarder-to-karakeep-migration/ — si vous avez une ancienne installation Hoarder à migrer.
• Retour au pilier : Plateforme médias self-hosted PME francophone : Jellyfin, PeerTube, Immich (2026)

FAQ

Site réalisé par [ITS] ITSkillsCenter — Formation IT professionnelle en Afrique de l’Ouest