122 lines
4.9 KiB
Markdown
122 lines
4.9 KiB
Markdown
---
|
||
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
|