# flatnotes

> Markdown notes you find by search and tags, not folders.

- Page: https://cgt.octabyte.io/templates/flatnotes/
- Category: Docs & wikis
- Replaces: Simplenote, Apple Notes and Obsidian
- Ease of use: Easy. Open the app's address and sign in with your username and the password Cloudgate generates.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: One person who wants a simple, private notes site, with notes kept as plain Markdown files
- Official website: https://flatnotes.io
- Documentation: https://github.com/dullage/flatnotes/wiki
- Source code: https://github.com/dullage/flatnotes
- Last updated: 2026-11-20

## What is flatnotes?

flatnotes is a self-hosted Markdown notes app to use in place of Simplenote: every note is a plain file, found by search, #tags and links between notes.

flatnotes is a free, open-source, self-hosted notes app that keeps every note as a plain Markdown file, and a simple alternative to Simplenote or Apple Notes. There are no folders or notebooks: you find notes by searching, by #tags written in the note, or from a home page of recent or pinned notes.

You write in plain Markdown or a visual editor, with checklists, tables, pictures and links between notes. Because each note is an ordinary file, your notes are never locked in: you can move them to another app whenever you like. A bike repair shop owner, for example, could keep the opening checklist, the service price list, the supplier order and how-to guides for new mechanics as tagged notes, and find any of them from the counter computer or a phone in a few keystrokes.

flatnotes works in any browser, on a computer or a phone; it has no phone or desktop app. It has a single account, so it suits one person, or a few people sharing one sign-in, rather than a team.

Cloudgate installs flatnotes on a server Cloudgate provides or one you connect and gives it a secure web address. You pick the username, Cloudgate generates the password, and you sign in straight away.

## What you can do with flatnotes

- **Write in Markdown or a visual editor**: Switch between plain Markdown and a what-you-see editor with buttons for headings, checklists, tables and links.
- **Find any note in a moment**: Press / anywhere to search every note, and narrow it down by title, tag, phrase or date changed.
- **Tag notes with a hashtag**: Write #suppliers or #howto anywhere in a note, then search by that tag to see every note on the subject.
- **Link notes together**: Type [[Note name]] to link to another note, so a how-to can point straight to the checklist it relies on.
- **Add pictures to notes**: Insert, drag in or paste an image and it is saved with your notes.
- **Pin notes to the home page**: The home page lists your recently changed notes, or a set you choose, such as everything tagged #pinned.
- **Keep your notes as plain files**: Every note is an ordinary Markdown file, so you can move them to another app at any time.

## Replaces Simplenote, Apple Notes and Obsidian

flatnotes does the same job as Simplenote, Apple Notes and Obsidian. Here is what changes when you switch.

### What you gain

- Your notes live on your own server, not in someone else's cloud
- Every note is a plain Markdown file you can take to any other app
- The same notes in any browser, on any computer or phone, with nothing to install
- Markdown, tables, wikilinks and tag search, with no subscription

### What is different

- There is no phone or desktop app; you use flatnotes in a browser
- It has one account, with no sharing of single notes and no editing together
- There are no folders or notebooks; you organise with search and tags
- There is no import tool for notes from Simplenote, Apple Notes or Obsidian

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=flatnotes

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. flatnotes itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up flatnotes.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is flatnotes free?

Yes. flatnotes is free and open source under the MIT licence, with no paid edition and no paid features. You pay only for your server.

### Is flatnotes a good Simplenote alternative?

Yes, if you want simple notes found by search and tags, kept on your own server. Like Simplenote it is minimal, with no notebooks, and it adds Markdown formatting, tables, images and links between notes. Simplenote has phone and desktop apps and shares notes with other people; flatnotes runs in a browser and has one account.

### How do I sign in to flatnotes the first time?

Sign in to flatnotes with the username you chose when you installed it and the password Cloudgate generated, shown on the app's variables page in Cloudgate. There is no sign-up page; changing those variables changes the sign-in.

### Can more than one person use flatnotes?

No, flatnotes has a single account. People who share that sign-in see and edit the same notes, but there are no separate accounts or per-note permissions.

### Can I bring my notes from Obsidian or another app?

Partly. flatnotes has no import tool, but it reads plain Markdown files, so Markdown notes such as an Obsidian vault can be copied into its notes folder on the server. It reads only notes at the top level of that folder, not in subfolders.

### Is there a flatnotes phone app?

No, flatnotes has no phone app. Its pages fit a phone screen, so you can read, search and write notes in your phone's browser.

### What server size does flatnotes need?

Very little. flatnotes is one small program with no database, so Cloudgate puts it on its smallest server size.

### Do I need technical skills to run flatnotes?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up flatnotes and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for flatnotes?

No. When you deploy flatnotes, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from Simplenote to flatnotes?

Most people export from Simplenote and import into flatnotes. The official guides at github.com walk through it.
