A lightweight, self-hosted memo hub. Open Source and Free forever.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
boojack 0b50122aac fix: version getter 3 years ago
.github/workflows fix: version getter 3 years ago
api chore: add service version 3 years ago
bin/server chore: add service version 3 years ago
common fix: version getter 3 years ago
resources chore: update `tech-stack.png` 3 years ago
scripts refactor: backend 3 years ago
server chore: add service version 3 years ago
store chore: add service version 3 years ago
web chore: add service version 3 years ago
.dockerignore feat: add build&push docker image action 3 years ago
.gitignore chore: add license and comments 3 years ago
CODEOWNERS chore: update readme 3 years ago
Dockerfile chore: update docker run commands 3 years ago
README.md fix: version getter 3 years ago
go.mod chore: address comments 3 years ago
go.sum chore(go): use `json` instead of `jsonapi` 3 years ago

README.md

✍️ Memos

An open source, quickly self-hosted alternative to flomo

GitHub stars Docker pull Go report

Live DemoDiscussions

demo

🎯 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;
  • 🤠 Great UI and never miss any detail;
  • 🚀 Super quick self-hosted with Docker and SQLite;

Deploy with Docker

docker run --name memos --publish 5230:8080 --volume ~/.memos/:/var/opt/memos -e mode=prod neosmemo/memos:0.0.1

If the ~/.memos/ does not have a memos_prod.db file, then memos will auto generate it.

🏗 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 (1.16 or later)
  • Air for backend live reload
  • yarn

Steps

  1. pull source code

    git clone https://github.com/justmemos/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 https://localhost:3000 and change either frontend or backend code would trigger live reload.

🌟 Star history

Star History Chart


Just enjoy it.