usememos--memos/README.en.md

✨ Featured Sponsor: CodeRabbit — Cut code review time & bugs in half, instantly.

Memos

Open-source, self-hosted note-taking tool built for quick capture. Markdown-native, lightweight, and fully yours.

Features

• Instant Capture — Timeline-first UI. Open, write, done — no folders to navigate.
• Total Data Ownership — Self-hosted on your infrastructure. Notes stored in Markdown, always portable. Zero telemetry.
• Radical Simplicity — Single Go binary, ~20MB Docker image. One command to deploy with SQLite, MySQL, or PostgreSQL.
• Open & Extensible — MIT-licensed with full REST and gRPC APIs for integration.

Quick Start

Docker (Recommended)

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

Open http://localhost:5230 and start writing!

Native Binary

curl -fsSL https://raw.githubusercontent.com/usememos/memos/main/scripts/install.sh | sh

Try the Live Demo

Don't want to install yet? Try our live demo first!

Other Installation Methods

• Docker Compose - Recommended for production deployments
• Pre-built Binaries - Available for Linux, macOS, and Windows
• Kubernetes - Helm charts and manifests available
• Build from Source - For development and customization

See our installation guide for detailed instructions.

Contributing

Contributions are welcome — bug reports, feature suggestions, pull requests, documentation, and translations.

• Report bugs
• Suggest features
• Submit pull requests
• Improve documentation
• Help with translations

Sponsors

• CodeRabbit - Cut code review time & bugs in half, instantly
• SSD Nodes - Affordable VPS hosting for self-hosters
• InstaPods - Get your app online in seconds • Deploy Memos in 30 Seconds

Love Memos? Sponsor us on GitHub to help keep the project growing!

Star History

License

Memos is open-source software licensed under the MIT License. See our Privacy Policy for details on data handling.

---

Website • Documentation • Demo • Discord • X/Twitter