title: flatnotes created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, note-taking, markdown, flatnotes, file-based, docker, minimal] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Note-Taking, https://github.com/dullage/flatnotes, https://github.com/dullage/flatnotes/wiki/Environment-Variables]

🗒️ flatnotes

L’application de notes Markdown sans base de données : simple, légère, centrée sur le contenu et basée sur un dossier plat de fichiers Markdown.

📋 Informations Générales

Champ	Valeur
Site web	GitHub dullage/flatnotes
GitHub	dullage/flatnotes
Licence	MIT
Langage	Python
Étoiles GitHub	3.1k ⭐
Dernière MAJ	2026-02-17
Catégorie	[[cat-note-taking

📝 Description

flatnotes est une application web de prise de notes Markdown volontairement simple et sans base de données. Les notes sont stockées dans un dossier plat de fichiers Markdown, ce qui rend l’outil particulièrement intéressant pour ceux qui veulent éviter l’enfermement dans un format propriétaire ou dans une structure complexe.

Le projet insiste sur une philosophie très claire : mettre le contenu en premier, réduire les distractions et permettre de manipuler les notes même en dehors de l’application. L’index de recherche est seulement mis en cache ; les fichiers peuvent être ajoutés, modifiés ou supprimés directement sur disque sans casser le modèle général.

flatnotes convient surtout à :

des notes personnelles Markdown ;
un wiki personnel léger ;
des utilisateurs qui veulent garder des fichiers lisibles directement ;
des homelabs cherchant un service simple à maintenir.

Points notables :

✅ Aucune base de données
✅ Notes en fichiers Markdown simples
✅ Recherche full-text
✅ Wikilinks
✅ Plusieurs modes d’authentification, dont TOTP
⚠️ Pas d’ambition forte côté collaboration ou knowledge graph avancé

🚀 Installation

Option recommandée : Docker Compose

Le README recommande explicitement Docker :

services:
  flatnotes:
    image: dullage/flatnotes:latest
    container_name: flatnotes
    restart: unless-stopped
    environment:
      PUID: 1000
      PGID: 1000
      FLATNOTES_AUTH_TYPE: password
      FLATNOTES_USERNAME: user
      FLATNOTES_PASSWORD: CHANGE_ME_PASSWORD
      FLATNOTES_SECRET_KEY: CHANGE_ME_LONG_RANDOM_SECRET
    volumes:
      - ./data:/data
    ports:
      - "8080:8080"

Puis :

docker compose up -d

Variables utiles

La documentation mentionne notamment :

FLATNOTES_AUTH_TYPE : none, read_only, password, totp
FLATNOTES_PATH_PREFIX pour un déploiement sous sous-chemin
FLATNOTES_TOTP_KEY si vous activez le mode TOTP

⚙️ Configuration Initiale

Créer le dossier data/ qui stockera les notes.
Choisir le mode d’authentification adapté.
Définir un FLATNOTES_SECRET_KEY aléatoire.
Démarrer l’application sur http://IP:8080.
Créer les premières notes et tester recherche, tags et wikilinks.
Si besoin, activer TOTP puis vérifier le QR code dans les logs du conteneur.

🔄 Alternatives

Open Source

app-notediscovery — Plus riche visuellement, plus proche d’Obsidian
app-haptic — Plus orienté expérience personnelle moderne Markdown
app-silverbullet — Beaucoup plus programmable
app-jotty — Mélange notes et checklists avec plus de fonctions UI
app-memos — Capture rapide plus sociale/micro-note

Propriétaires

Simplenote
Bear
Obsidian Sync
Notion

🔐 Sécurité

✅ Les notes restent dans un dossier simple facile à sauvegarder
✅ Le projet propose authentification et TOTP
✅ Utilisez un secret aléatoire pour les jetons d’accès
✅ Exposez l’instance derrière HTTPS si elle sort du réseau local
⚠️ Si vous utilisez none, l’instance ne doit pas être publique

📚 Ressources

Pages Liées

cat-note-taking — Vue d’ensemble de la catégorie Note-Taking
app-notediscovery — Alternative plus riche
app-silverbullet — Alternative programmable
app-haptic — Alternative Markdown personnelle

4.7 KiB Raw Blame History Unescape Escape