mirror of https://github.com/usememos/memos
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.
d1cef7a9ab
Run the instance in private mode when instance_url is not configured: the API rejects anonymous requests except the auth-bootstrap set (sign-in, token refresh, instance profile/settings, SSO providers, share-link access) plus first-run user creation, and the web UI redirects anonymous visitors to /auth instead of /explore. Setting instance_url keeps the current public behavior. Access tokens and personal access tokens are never gated. Enforcement lives in a shared Authorizer used by both the Connect interceptor and the gRPC-gateway middleware; the file server applies the same rule to public-memo attachments and avatars. Also merges the duplicated Authenticate/AuthenticateToUser token dispatch behind resolveBearer, dedups the AuthContext unauthenticated state, extracts the redirect decision into a pure shouldGatePrivateInstance helper, and prints the access mode at startup. |
6 days ago | |
|---|---|---|
| .github | 1 month ago | |
| cmd/memos | 6 days ago | |
| docs | 4 weeks ago | |
| internal | 6 days ago | |
| proto | 2 weeks ago | |
| scripts | 1 week ago | |
| server | 6 days ago | |
| store | 1 week ago | |
| web | 6 days ago | |
| .dockerignore | 6 months ago | |
| .gitignore | 3 months ago | |
| .golangci.yaml | 6 months ago | |
| .release-please-manifest.json | 1 month ago | |
| AGENTS.md | 1 month ago | |
| CHANGELOG.md | 1 month ago | |
| CODEOWNERS | 4 months ago | |
| LICENSE | ||
| README.md | 1 week ago | |
| SECURITY.md | 3 months ago | |
| go.mod | 4 weeks ago | |
| go.sum | 4 weeks ago | |
| release-please-config.json | 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.
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
