✍️ Memos

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

GitHub stars Docker pull Go report

Live DemoDiscuss in Telegram

![demo](https://raw.githubusercontent.com/usememos/memos/main/resources/demo.webp) ## 🎯 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 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](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 tech stack ### Prerequisites - [Go](https://golang.org/doc/install) (1.16 or later) - [Air](https://github.com/cosmtrek/air#installation) for backend live reload - [yarn](https://yarnpkg.com/getting-started/install) ### Steps 1. pull source code ```bash git clone https://github.com/usememos/memos ``` 2. start backend using air(with live reload) ```bash air -c scripts/.air.toml ``` 3. start frontend dev server ```bash cd web && yarn && yarn dev ``` Memos should now be running at [http://localhost:3000](http://localhost:3000) and change either frontend or backend code would trigger live reload. ## 🌟 Star history [![Star History Chart](https://api.star-history.com/svg?repos=usememos/memos&type=Date)](https://star-history.com/#usememos/memos&Date) --- Just enjoy it.