flatnotes logo

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.