flatnotes
Database-less note-taking web app using a flat folder of Markdown files
Alternative to: evernote, google keep
A distraction-free, self-hosted note-taking web app that stores notes as plain Markdown files in a flat folder, with no database. Features full-text search, tagging, wikilinks, raw and WYSIWYG editor modes, a mobile-responsive interface, optional 2FA login and a REST API.
flatnotes Docker Compose example
Self-host flatnotes on your own server, homelab, or VPS starting from this Docker Compose example.
It runs flatnotes in Docker containers using the official dullage/flatnotes:latest image, with persistent volumes and automatic restarts preconfigured.
Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.
services:
flatnotes:
image: dullage/flatnotes:latest
volumes:
- data:/data
restart: unless-stopped
environment:
# User ID the flatnotes process runs as (owner of the files in /data).
PUID: "1000"
# Group ID the flatnotes process runs as.
PGID: "1000"
# Authentication type: none, read_only, password or totp.
FLATNOTES_AUTH_TYPE: "password"
# Username for logging in to flatnotes.
FLATNOTES_USERNAME: "user"
# Password for logging in to flatnotes.
FLATNOTES_PASSWORD: "changeme"
# Long random string used to sign login session tokens.
FLATNOTES_SECRET_KEY: "changeme"
volumes:
data:
Values set to changeme are required — replace them with your own
values before starting flatnotes.
Prefer a managed setup? WinterFlow installs, configures, and updates flatnotes for you using this same Docker Compose configuration.