Flatnotes

A self-hosted, database-less note taking web app that utilises a flat folder of markdown files for storage.

  • Other
  • Productivity
  • Tools & Utilities
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

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

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

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

Collected 53 days ago - public community threads