A lightweight, self-hosted memo hub. Open Source and Free forever.

self-hosted docker react free go markdown memo note-taking sqlite

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 3a55edd917 fix(scripts): prevent entrypoint restart loop when MEMOS_UID=0 The root-drop guard only checked `id -u = 0`, so when the target user was also root (MEMOS_UID=0, common under rootless Docker with userns-remap) su-exec re-execed back into root, re-entered the block, and looped forever without ever reaching the memos binary — the container hung with no logs. Add a MEMOS_ENTRYPOINT_SWITCHED marker (preserved across the su-exec re-exec) so the privilege drop runs at most once, and log the resolved UID:GID on startup so this path is never silent again. Closes #6061		1 week ago
.github	chore(github): improve issue templates with structured triage fields	1 month ago
cmd/memos	feat: add configurable `--log-level` flag (#5934 )	2 months ago
docs	feat(filter): expand CEL filter surface with startsWith/endsWith, matches(), and all()	4 weeks ago
internal	refactor: use the built-in max/min to simplify the code (#6060 )	1 week ago
proto	chore(mcp): improve tool discoverability, add orientation tools and evals	2 weeks ago
scripts	fix(scripts): prevent entrypoint restart loop when MEMOS_UID=0	1 week ago
server	refactor: use the built-in max/min to simplify the code (#6060 )	1 week ago
store	refactor: use the built-in max/min to simplify the code (#6060 )	1 week ago
web	fix(editor): make formatting commands toggle and convert correctly	1 week ago
.dockerignore	perf: optimize CI/CD workflows and Docker builds	6 months ago
.gitignore	feat(auth): add SSO user identity linkage (#5883 )	3 months ago
.golangci.yaml	fix(ci): remove invalid revive rule 'use-waitgroup-go' from golangci-lint config	6 months ago
.release-please-manifest.json	chore(main): release 0.29.1 (#5985 )	1 month ago
AGENTS.md	docs: rewrite agent repository guide	1 month ago
CHANGELOG.md	chore(main): release 0.29.1 (#5985 )	1 month ago
CODEOWNERS	chore: tweak CODEOWNERS	4 months ago
LICENSE	chore: update LICENSE (#4394 )	1 year ago
README.md	chore: tweak readme	1 week ago
SECURITY.md	chore: update security.md	3 months ago
go.mod	feat(filter): expand CEL filter surface with startsWith/endsWith, matches(), and all()	4 weeks ago
go.sum	feat(filter): expand CEL filter surface with startsWith/endsWith, matches(), and all()	4 weeks ago
release-please-config.json	chore: add release-please automation (#5842 )	3 months ago

README.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.

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