✍️ Memos

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

Live Demo • Discuss in Telegram 👾

Features

• 🦄 Fully open source;
• 📜 Writing in plain textarea without any burden,
  • and support some useful markdown syntax 💪.
• 🌄 Share the memo in a pretty image or personal page like Twitter;
• 🚀 Fast self-hosting with Docker;
• 🤠 Pleasant UI and UX;

Deploy with Docker

Docker Run

docker run -d --name memos -p 5230:5230 -v ~/.memos/:/var/opt/memos neosmemo/memos:latest

Docker Compose

version: "3.0"
services:
  memos:
    image: neosmemo/memos:latest
    container_name: memos
    volumes:
      - ~/.memos/:/var/opt/memos
    ports:
      - 5230:5230
    restart: unless-stopped

Memos should be running at http://localhost:5230. 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

Prerequisites

• Go
• Air for backend live reload
• Node.js
• 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.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. 🥰

Star history