Guide de déploiement

Blinko : notes IA self-hosted avec recherche sémantique

Déployer sur un VPS Cloud →

Tutoriel

Blinko : notes IA self-hosted avec recherche sémantique

Self-hosting6 min de lecture5 étapes

Blinko est une application de prise de notes open-source orientée IA (GPL-3.0, plus de 11 000 étoiles) conçue pour les développeurs et les travailleurs de la connaissance. Contrairement à Notion ou Obsidian Cloud, vos notes restent sur votre propre serveur — sans abonnement, sans synchronisation involontaire avec des tiers. L'interface basée sur des cartes, la recherche sémantique intégrée et le moteur RAG (Retrieval-Augmented Generation) font de Blinko un outil de capture et de retrouvaille de la connaissance particulièrement efficace pour les développeurs qui veulent garder le contrôle de leurs données.

Sommaire· Pourquoi héberger vos notes sur votre propre VPS ?1/8
  1. 01Pourquoi héberger vos notes sur votre propre VPS ?
  2. 02Ce que Blinko apporte sur un VPS ServOrbit
  3. 03Accès sans domaine : tunnel SSH ou sous-domaine gratuit
  4. 04Démarrer avec Blinko sur ServOrbit
  5. 05Connecter la recherche IA et aller plus loin
  6. 06Blinko vs Memos vs Obsidian : quelle app pour quel usage ?
  7. 07Automatiser la capture avec l'API REST de Blinko
  8. 08Migration depuis un autre outil de prise de notes

Pourquoi héberger vos notes sur votre propre VPS ?

Les outils de prise de notes cloud centralisent vos idées sur leurs serveurs et peuvent les analyser pour améliorer leur produit ou entraîner leurs modèles. Avec Blinko, le stockage est sur votre propre VPS : vos notes, vos pièces jointes et votre historique de capture ne quittent jamais votre machine sauf si vous le décidez explicitement. Vous gardez le contrôle total sur vos données — y compris les réflexions sensibles, les notes clients ou les recherches non publiées.

Ce que Blinko apporte sur un VPS ServOrbit

  • Capture par cartes — chaque note est une carte atomique, optimisée pour la saisie rapide et la récupération plutôt que pour la rédaction longue. Tapez une idée, appuyez sur Entrée, retrouvez-la en secondes.
  • Recherche sémantique et RAG intégrés — connectez un modèle Ollama local ou tout endpoint compatible OpenAI pour interroger vos notes en langage naturel : « qu'est-ce que j'ai écrit sur les rate limits la semaine dernière ? »
  • Recherche plein texte + vectorielle — Blinko combine la recherche par mots-clés classique et la similarité vectorielle pour retrouver une note même si vous ne vous souvenez plus des mots exacts.
  • Étiquettes et filtres — organisez vos cartes par étiquette, type (note, tâche, marque-page) et filtrez la chronologie en un clic pour retrouver n'importe quel contexte.
  • Progressive Web App — accessible depuis n'importe quel appareil sans installer d'application ; l'interface est optimisée pour la capture rapide sur mobile.
  • Multi-utilisateurs — invitez des membres de votre équipe, chacun avec son espace de notes privé sur une instance partagée.
  • API REST — automatisez la création de cartes depuis des scripts, des pipelines CI, des bots ou tout client HTTP.
  • GPL-3.0 — sans télémétrie, sans compte cloud obligatoire, sans verrouillage propriétaire.

Accès sans domaine : tunnel SSH ou sous-domaine gratuit

Blinko fonctionne sans nom de domaine. L'application publie son port uniquement sur localhost (127.0.0.1), ce qui signifie que depuis l'extérieur, l'accès nécessite soit un tunnel SSH, soit un domaine avec reverse proxy. Pour le tunnel : ssh -L 1111:127.0.0.1:<port> root@<ip-vps> (le port réel est affiché dans votre espace client, pas nécessairement 1111) puis ouvrez http://localhost:1111. Pour un accès permanent depuis vos appareils, rattachez l'un de vos domaines depuis votre espace client ServOrbit — nginx proxifie le conteneur en HTTPS avec renouvellement automatique du certificat — ou utilisez le sous-domaine gratuit {app}.{dns_slug}.servorbit-dns.com inclus avec chaque VPS.

Démarrer avec Blinko sur ServOrbit

  1. Créer votre VPS et déployer Blinko

    Dans votre espace client ServOrbit, allez dans Marketplace → Collaboration et productivité → Blinko, et cliquez sur Déployer. Sélectionnez Ubuntu 24.04 et validez. Docker récupère les images blinkospace/blinko:1.8.8 et postgres:14-alpine, exécute les migrations et démarre les deux conteneurs automatiquement.

  2. Créer votre compte administrateur

    Ouvrez l'adresse affichée dans votre espace client. Sans domaine, ouvrez d'abord un tunnel SSH : ssh -L 1111:127.0.0.1:<port> root@<ip-de-votre-vps> puis naviguer vers http://localhost:1111. Cliquez sur « S'inscrire » — le tout premier compte créé devient automatiquement administrateur de l'instance.

  3. Commencer à capturer des notes

    Saisissez une idée dans la zone de saisie en haut de page et appuyez sur Entrée. Ajoutez des étiquettes avec #etiquette directement dans le texte. La barre de recherche cherche en plein texte sur l'ensemble de votre historique.

  4. Connecter un modèle d'IA (optionnel)

    Dans Paramètres → IA, entrez une URL d'endpoint compatible OpenAI et un nom de modèle. Pour garder tout sur votre serveur, déployez Ollama depuis le Marketplace (catégorie IA et Machine Learning) sur le même VPS, puis pointez Blinko sur http://localhost:<port-ollama>/v1. Blinko indexe vos notes sous forme de vecteurs et la barre de recherche comprend les questions en langage naturel.

  5. Sauvegarder vos données

    Toutes vos notes et pièces jointes vivent dans deux volumes Docker : blinko-db (PostgreSQL) et blinko-uploads (fichiers). Pour un dump de la base : docker exec blinko-db-1 sh -c 'pg_dump -U blinko blinko' > backup.sql. Copiez ce fichier et le dossier blinko-uploads via SFTP pour une sauvegarde complète. La restauration se fait en important le dump dans un nouveau conteneur PostgreSQL.

Connecter la recherche IA et aller plus loin

La puissance de Blinko réside dans son moteur RAG : une fois un modèle connecté, vous pouvez poser des questions sur l'ensemble de votre historique de notes en langage naturel. Par exemple, demandez « résume mes notes sur le projet X » ou « qu'est-ce que j'ai décidé sur l'architecture de l'API ? » — Blinko retrouve les cartes pertinentes et synthétise une réponse. Le tout reste sur votre VPS. Pour les développeurs qui automatisent leur workflow, l'API REST de Blinko permet de créer des cartes depuis n'importe quel outil : un script de déploiement qui consigne les releases, un bot Slack qui archive les décisions, ou un cron qui loggue les métriques de la veille.

Blinko vs Memos vs Obsidian : quelle app pour quel usage ?

Trois apps reviennent souvent dans le même souffle : Blinko, [Memos](/blog/self-host-memos-vps) et Obsidian. Elles couvrent des besoins différents. Memos excelle pour les flux de microblogging court — idées éphémères, logs de journée — mais sa recherche reste textuelle. Obsidian brille pour les grandes bibliothèques structurées (dossiers, liens bidirectionnels, graphe), mais sa synchronisation cloud est payante et l'install est locale (pas serverless). Blinko occupe le milieu : capture aussi rapide que Memos, avec une recherche sémantique qui répond aux questions en langage naturel sur votre historique, et une architecture Docker entièrement auto-hébergée. [SiYuan](/blog/self-host-siyuan-vps) est une autre option si vous préférez un éditeur par blocs complet à une interface orientée capture.

Automatiser la capture avec l'API REST de Blinko

  • Logger les déploiements CI — appelez l'API Blinko depuis votre pipeline GitHub Actions pour créer une carte à chaque release : curl -X POST https://votre-blinko/api/v1/note/upsert -H 'Authorization: Bearer <token>' -d '{"content": "Release v1.2.3 déployée"}'.
  • Archiver les décisions Slack — un webhook Slack peut créer une carte Blinko à chaque fois qu'un message est ⭐ étoilé dans un canal projet.
  • Cron de métriques — un script quotidien qui lit vos métriques (trafic, erreurs, revenus) et les envoie à Blinko constitue un journal de bord historisé interrogeable par l'IA.
  • Bot de pull-requests — un script qui parcourt les PR GitHub fermées la veille et crée une carte par PR importante — titre, lien, labels — génère automatiquement un changelog navigable en langage naturel.
  • Import depuis Notion — exportez vos pages Notion en Markdown et utilisez un script qui les découpe en cartes atomiques via l'API pour migrer sans perte de contenu.

Migration depuis un autre outil de prise de notes

Migrer vers Blinko est simple : l'API REST accepte n'importe quelle chaîne Markdown comme contenu de carte. Si vous quittez Notion, exportez en Markdown (Paramètres → Export → Markdown et CSV), puis découpez chaque fichier en cartes via un script Python ou Node.js qui appelle POST /api/v1/note/upsert. Si vous quittez Obsidian, les fichiers .md sont déjà du Markdown pur — un find + curl en boucle suffit. Pour Memos, son API d'export JSON est consommable directement. Les pièces jointes se transfèrent via POST /api/v1/file/upload. Une fois vos données dans Blinko, lancez la réindexation vectorielle depuis Paramètres → IA pour que la recherche sémantique couvre l'ensemble de votre historique importé dès le premier soir.

Déployez Blinko sur votre VPS

ServOrbit déploie un VPS Ubuntu 24.04 et lance Blinko avec sa base de données PostgreSQL dans deux conteneurs Docker en quelques minutes — données sous votre contrôle, recherche IA incluse.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail. Support en français, anglais et arabe.

Écrire sur WhatsApps'ouvre dans un nouvel onglet