FUTO Notes docs

FUTO Notes is a private, local-first notes app built on plain markdown files, for iOS, Android, Linux, macOS, and Windows. These guides cover installing it, using it, syncing between devices, and running your own sync server. For quick answers, start with the FAQ.

Install

• Linux: apt and dnf repositories, or an AppImage
• macOS, Windows, Android, and iPhone and iPad
• Updates: which installs update themselves, and which don’t

Using the app

• Markdown, wikilinks, and keyboard shortcuts
• Search and folders and tags
• Settings: every option, and what Full reset deletes
• Where notes are stored and the file format
• Use FUTO Notes with an Obsidian vault

Sync

• How sync works and what syncs
• Conflicts and renames and deletes
• The sync password: where it lives, and how to change it safely
• Troubleshooting: every sync message and its fix

Run your own sync server

• Set up the server with one command
• Configuration and reverse proxy setup for nginx, Caddy, and Traefik
• Backup and restore, storage growth, and errors, health, and logs
• Postgres to SQLite for older installs, and the sync API

Security and privacy

• How the encryption works and what the server can see
• Network requests and crash reports and feedback

Contributing

• Build from source, translations, and the license

Next steps

• Download FUTO Notes: get the app for your phone or computer.
• FAQ: short answers to the common questions.