Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,121 @@
+---
+title: SilverBullet
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, note-taking, markdown, silverbullet, pkm, lua, self-hosted, docker]
+confidence: high
+contested: false
+sources: [https://selfh.st/apps/?tag=Note-Taking, https://silverbullet.md, https://silverbullet.md/Install, https://github.com/silverbulletmd/silverbullet]
+---
+
+# 🥈 SilverBullet
+
+> **La base de connaissances personnelle programmable en Markdown** : wiki-links, requêtes, scripts Lua et auto-hébergement léger pour un PKM très modulable.
+
+## 📋 Informations Générales
+
+| Champ | Valeur |
+| :--- | :--- |
+| **Site web** | [silverbullet.md](https://silverbullet.md) |
+| **GitHub** | [silverbulletmd/silverbullet](https://github.com/silverbulletmd/silverbullet) |
+| **Licence** | MIT |
+| **Langage** | TypeScript, Go |
+| **Étoiles GitHub** | 5.4k ⭐ |
+| **Dernière MAJ** | 2026-06-02 |
+| **Catégorie** | [[cat-note-taking|Note-Taking]] |
+
+## 📝 Description
+
+**SilverBullet** se décrit comme une **base de connaissances personnelle privée, auto-hébergeable et programmable**, construite autour de **fichiers Markdown**. C’est une solution très attractive pour les utilisateurs qui aiment les liens wiki, les backlinks, les objets structurés et surtout l’idée de **faire évoluer leurs notes en système programmable**.
+
+L’application combine plusieurs approches : un éditeur Markdown avec aperçu vivant, des **liens bidirectionnels**, une couche **requêtes/base intégrée**, ainsi qu’un environnement **Space Lua** pour générer du contenu, automatiser des commandes ou bâtir des extensions. On est donc entre la prise de notes personnelle, le wiki et le petit système d’automatisation documentaire.
+
+SilverBullet convient surtout à :
+
+- des utilisateurs **PKM / second brain** ;
+- des notes **Markdown interconnectées** ;
+- des profils techniques qui veulent **script-er** leur espace ;
+- un homelab léger, y compris sur **Raspberry Pi** ou petit VPS.
+
+Points notables :
+
+- ✅ Notes **Markdown**
+- ✅ **Wiki-links** et backlinks
+- ✅ **Lua** intégré pour la programmabilité
+- ✅ Déploiement léger en **binaire** ou **Docker**
+- ⚠️ Le projet recommande un **filesystem sensible à la casse** côté serveur
+- ⚠️ Pour un accès distant réel, **HTTPS** est requis par le navigateur
+
+## 🚀 Installation
+
+### Option recommandée : Docker
+
+Le projet fournit une image officielle et insiste sur la nécessité de **monter explicitement `/space`** pour la persistance :
+
+```yaml
+services:
+  silverbullet:
+    image: ghcr.io/silverbulletmd/silverbullet:latest
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./space:/space
+```
+
+Puis :
+
+```bash
+docker compose up -d
+```
+
+### Point d’attention stockage
+
+SilverBullet déconseille un usage réel sur un **filesystem insensible à la casse**. En pratique, un serveur **Linux** reste la cible la plus sûre pour éviter des problèmes de noms de pages et de timestamps.
+
+## ⚙️ Configuration Initiale
+
+1. **Créer un dossier `space/`** qui accueillera les pages Markdown.
+2. **Démarrer le conteneur** et ouvrir `http://localhost:3000` pour un premier test.
+3. **Activer l’authentification** avant toute exposition à d’autres appareils.
+4. **Placer un reverse proxy HTTPS** devant l’application pour l’accès distant.
+5. **Créer les premières pages**, liens wiki et éventuelles requêtes.
+6. **Tester les scripts Lua** uniquement après sauvegarde de l’espace.
+
+## 🔄 Alternatives
+
+### Open Source
+- [[app-siyuan]] — PKM riche avec approche plus applicative
+- [[app-trilium-notes]] — Notes hiérarchiques et base de connaissances avancée
+- [[app-notediscovery]] — Plus simple, plus léger, moins programmable
+- [[app-flatnotes]] — Beaucoup plus minimaliste et sans base de données
+- [[app-haptic]] — Approche Markdown personnelle plus épurée
+
+### Propriétaires
+- **Obsidian**
+- **Craft**
+- **Notion**
+- **Capacities**
+
+## 🔐 Sécurité
+
+- ✅ Activez l’**authentification** sur toute instance accessible au réseau
+- ✅ Exposez l’application derrière **HTTPS** pour que les APIs navigateur nécessaires fonctionnent correctement
+- ⚠️ Évitez les filesystems problématiques côté serveur
+- ✅ Sauvegardez régulièrement le dossier **`/space`**
+- ⚠️ Les scripts et automatisations doivent être traités comme du **code exécutable**
+
+## 📚 Ressources
+
+- [Site officiel](https://silverbullet.md)
+- [Guide d’installation](https://silverbullet.md/Install)
+- [GitHub silverbulletmd/silverbullet](https://github.com/silverbulletmd/silverbullet)
+- [Playlist de démonstration](https://www.youtube.com/watch?v=bb1USz_cEBY&list=PLxFAb_vXRcEp4465MVI6Ha9wzNiX5VevQ)
+
+## Pages Liées
+
+- [[cat-note-taking]] — Vue d’ensemble de la catégorie Note-Taking
+- [[app-siyuan]] — Alternative PKM riche
+- [[app-flatnotes]] — Alternative ultra simple
+- [[app-haptic]] — Alternative Markdown personnelle