memos/README.md

✍️ Memos

An open source, self-hosted knowledge base that works with a SQLite db file.

Live Demo • Discuss in Telegram

🎯 Intentions

• ✍️ Write down the light-card memos very easily;
• 🏗️ Build the fragmented knowledge management tool for yourself;
• 📒 For noting your 📅 daily/weekly plans, 💡 fantastic ideas, 📕 reading thoughts...

✨ Features

• 🦄 Fully open source;
• 👍 Write in the plain textarea without any burden;
• 🤠 Great UI and never miss any detail;
• 🚀 Super quick self-hosted with Docker and SQLite;

⚓️ Deploy with Docker

docker run \
  --name memos \
  --publish 5230:5230 \
  --volume ~/.memos/:/var/opt/memos \
  neosmemo/memos:latest \
  --mode prod \
  --port 5230

Memos should now be running at http://localhost:5230. If the ~/.memos/ does not have a memos_prod.db file, then memos will auto generate it.

⚠️ Please DO NOT use dev of docker image if you have no experience.

🏗 Development

Memos is built with a curated tech stack. It is optimized for developer experience and is very easy to start working on the code:

1. It has no external dependency.
2. It requires zero config.
3. 1 command to start backend and 1 command to start frontend, both with live reload support.

Tech Stack

Prerequisites

• Go (1.16 or later)
• Air for backend live reload
• yarn

Steps

1. pull source code

   git clone https://github.com/usememos/memos
   

2. start backend using air(with live reload)

   air -c scripts/.air.toml
   

3. start frontend dev server

   cd web && yarn && yarn dev
   

Memos should now be running at http://localhost:3000 and change either frontend or backend code would trigger live reload.

🌟 Star history

---

Just enjoy it.