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.
129 lines
5.5 KiB
Markdown
129 lines
5.5 KiB
Markdown
# Memos
|
|
|
|
<img align="right" height="96px" src="https://www.usememos.com/logo-rounded.png" alt="Memos" />
|
|
|
|
A modern, open-source, self-hosted knowledge management and note-taking platform designed for privacy-conscious users and organizations. Memos provides a lightweight yet powerful solution for capturing, organizing, and sharing thoughts with comprehensive Markdown support and cross-platform accessibility.
|
|
|
|
<div align="center">
|
|
|
|
[](https://www.usememos.com)
|
|
[](https://www.usememos.com/docs)
|
|
[](https://demo.usememos.com/)
|
|
[](https://www.usememos.com/blog)
|
|
|
|
[](https://hub.docker.com/r/neosmemo/memos)
|
|
[](https://hub.docker.com/r/neosmemo/memos)
|
|
[](https://discord.gg/tfPJa4UmAv)
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- Premium Sponsors -->
|
|
<!--
|
|
<div align="center">
|
|
<p><em>Support Memos development and get your brand featured here</em></p>
|
|
<a href="https://sponsor-website.com" target="_blank">
|
|
<img src="https://sponsor-logo-url.com/logo.png" alt="Sponsor Name" height="60" style="margin: 10px;">
|
|
</a>
|
|
</div>
|
|
-->
|
|
|
|
## Table of Contents
|
|
|
|
- [Table of Contents](#table-of-contents)
|
|
- [Overview](#overview)
|
|
- [Key Features](#key-features)
|
|
- [Quick Start](#quick-start)
|
|
- [Sponsors](#sponsors)
|
|
- [Contributing](#contributing)
|
|
- [Star History](#star-history)
|
|
|
|
## Overview
|
|
|
|
Memos is a lightweight, self-hosted alternative to cloud-based note-taking services. Built with privacy and performance in mind, it offers a comprehensive platform for personal knowledge management without compromising data ownership or security.
|
|
|
|
## Key Features
|
|
|
|
### Privacy & Security
|
|
|
|
- **Complete Data Ownership** — All data stored locally in your chosen database
|
|
- **Self-Hosted Architecture** — Full control over infrastructure and access policies
|
|
- **No External Dependencies** — Zero third-party services or cloud connections required
|
|
|
|
### Content Creation
|
|
|
|
- **Instant Save** — Streamlined plain text input with automatic persistence
|
|
- **Rich Markdown Support** — Full Markdown rendering with syntax highlighting
|
|
- **Media Integration** — Native support for images, links, and embedded content
|
|
|
|
### Performance & Technology
|
|
|
|
- **High-Performance Backend** — Built with Go for optimal resource utilization
|
|
- **Modern React Frontend** — Responsive, intuitive user interface
|
|
- **Lightweight Deployment** — Minimal system requirements, maximum efficiency
|
|
- **Cross-Platform** — Linux, macOS, Windows, and containerized environments
|
|
|
|
### Customization
|
|
|
|
- **Configurable Interface** — Custom branding, themes, and UI elements
|
|
- **API-First Design** — RESTful API for seamless third-party integrations
|
|
- **Multi-Database Support** — SQLite, PostgreSQL, and MySQL compatibility
|
|
|
|
### Cost-Effective
|
|
|
|
- **Open Source (MIT)** — Full source code availability with permissive licensing
|
|
- **Zero Subscription Fees** — No usage limits, premium tiers, or hidden costs
|
|
- **Community-Driven** — Transparent development with active community support
|
|
|
|
## Quick Start
|
|
|
|
Get Memos running in under 1 minutes with Docker:
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name memos \
|
|
--restart unless-stopped \
|
|
-p 5230:5230 \
|
|
-v ~/.memos:/var/opt/memos \
|
|
neosmemo/memos:stable
|
|
```
|
|
|
|
Access Memos at `http://localhost:5230` and complete the initial setup.
|
|
|
|
**Alternative methods**: For Docker Compose, binary installation, or building from source, see our [Installation Guide](https://www.usememos.com/docs/installation).
|
|
|
|
**Pro Tip**: The data directory stores all your notes, uploads, and settings. Include it in your backup strategy!
|
|
|
|
## Sponsors
|
|
|
|
Memos is made possible by the generous support of our sponsors. Their contributions help ensure the project's continued development, maintenance, and growth.
|
|
|
|
<a href="https://github.com/yourselfhosted" target="_blank"><img src="https://avatars.githubusercontent.com/u/140182318?v=4" alt="yourselfhosted" height="60" /></a>
|
|
<a href="https://github.com/fixermark" target="_blank"><img src="https://avatars.githubusercontent.com/u/169982?v=4" alt="fixermark" height="60" /></a>
|
|
<a href="https://github.com/alik-agaev" target="_blank"><img src="https://avatars.githubusercontent.com/u/2662697?v=4" alt="alik-agaev" height="60" /></a>
|
|
|
|
<p><strong>Every contribution, no matter the size, makes a difference!</strong></p>
|
|
|
|
<a href="https://github.com/sponsors/usememos" target="_blank">
|
|
<img src="https://img.shields.io/badge/Sponsor-❤️-red?style=for-the-badge" alt="Sponsor Memos">
|
|
</a>
|
|
|
|
## Contributing
|
|
|
|
Memos welcomes contributions from developers, designers, and users worldwide. We value quality, innovation, and community feedback.
|
|
|
|
**Ways to Contribute:**
|
|
|
|
- Code contributions (bug fixes, features, performance improvements)
|
|
- Documentation and user guides
|
|
- Testing and bug reporting
|
|
- Localization and translation
|
|
- Community support
|
|
|
|
**Get Started**: [Contributing Guide](https://github.com/usememos/memos/blob/main/CONTRIBUTING.md) • [Code of Conduct](https://github.com/usememos/memos/blob/main/CODE_OF_CONDUCT.md)
|
|
|
|
## Star History
|
|
|
|
[](https://star-history.com/#usememos/memos&Date)
|