flatnotes

flatnotes is a self-hosted, database-less note-taking app. It stores every note as a plain Markdown file in a single flat folder, so your notes stay portable and readable with or without the app. MIT licensed with 3,100+ GitHub stars.

At a glance

3.2k

GitHub stars

Page views

203

Active installs

License MIT Version Latest OS Ubuntu Server 24.04 LTS Min RAM 1 GB IP IPV4,IPV6

Active installs is sample data (staging preview); real metric wires in before launch.

Deploy flatnotes on a VPS ← All apps

Access

Open URL: http://<SERVER_IP>:8080

Username: user
Password: stored in /root/flatnotes/.env as FLATNOTES_PASSWORD

Retrieve credentials:

cat /root/flatnotes/.env

Important Files and Directories

Install Path: /root/flatnotes
Compose File: /root/flatnotes/docker-compose.yml
Environment File: /root/flatnotes/.env
Data Directory: /root/flatnotes/data

Docker Management

Check status:

docker compose -f /root/flatnotes/docker-compose.yml ps

View logs:

docker compose -f /root/flatnotes/docker-compose.yml logs -f

Restart service:

docker compose -f /root/flatnotes/docker-compose.yml restart

Stop service:

docker compose -f /root/flatnotes/docker-compose.yml down

Start service:

docker compose -f /root/flatnotes/docker-compose.yml up -d

Related apps.

Ackee

Actual

AFFiNE

AList

Deploy flatnotes now. From $2.48/mo.

Deploy a VPS See all plans