Flatnotes
A self-hosted, database-less note taking web app that utilises a flat folder of markdown files for storage.
Platform availability
Available on 4 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel
- ZimaOS (not listed)
- Proxmox
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
64/100 Good
- Maintained
- 69last commit 84 days ago
- Popular
- 703,269 GitHub stars
- Easy to install
- 654 install platforms, install notes, Docker image
- Light to run
- 95512 MB minimum RAM, runs on ARM
- Security check
- 201 serious finding, 12 minor
Security check: 1 serious finding
- Uses python-jose 3.5.0, which has a known critical vulnerability (PyPI)
Automated checks on commit 7f5b773, 21 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 7 days ago
- GitHub stars
- 3,269
- Open issues
- 125
- Last commit
- 2026-08-29
- Latest release
- v5.5.5
- License
- MIT
- Activity
- stale
Checked 20 days ago - source: GitHub (Dullage/flatnotes)
Resources & Compatibility
Minimum requirements: 512 MB RAM, 1 CPU core(s), 5 GB disk. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set your login and secret first Before starting the app, replace FLATNOTES_USERNAME, FLATNOTES_PASSWORD, and FLATNOTES_SECRET_KEY with your own login name, a strong password, and a long random secret. If you leave the sample values in, anyone could guess how to sign in and the secret will be unsafe. source
- Keep the data folder safe The ./data folder you attach to the container is where Flatnotes stores your notes and settings, so keep it on a drive you back up regularly. If that folder is deleted or corrupted, the notes inside the container will be gone. source
- Match PUID/PGID to your account PUID and PGID (the user and group IDs the container runs as) should usually match your Linux account, such as 1000. This helps the container read and write your data folder without permission errors. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How are FlatNotes notes stored?
Notes are stored as Markdown files in a flat folder, not in a database.
Does FlatNotes support image handling?
Image support was improved in the v3.4 release.
Can I configure different authentication methods?
FlatNotes offers multiple authentication options.
Can I organise notes with links and tags?
It supports wikilinks, tagging, and advanced search.
Answers sourced from dev.to, github.com, www.reddit.com
Community
- r/selfhosted on Reddit: flatnotes - A note taking web app that uses a ... (reddit)
- flatnotes - Improved image support in the v3.4 release - Reddit (reddit)
- Happy Star Wars Day! flatnotes 3.0 is now available and ... - Reddit (reddit)
Collected 53 days ago - public community threads