memos/README.md

59 lines
3.4 KiB
Markdown
Raw Normal View History

2024-09-25 19:47:12 +08:00
# Memos - Open Source, Self-hosted, Your Notes, Your Way
2024-09-25 19:47:12 +08:00
<img align="right" height="96px" src="https://www.usememos.com/logo-rounded.png" alt="Memos" />
An open-source, self-hosted note-taking solution designed for seamless deployment and multi-platform access. Experience effortless plain text writing with pain-free, complemented by robust Markdown syntax support for enhanced formatting.
2023-10-26 09:00:36 +08:00
<a href="https://www.usememos.com">Home Page</a>
<a href="https://www.usememos.com/blog">Blogs</a>
<a href="https://www.usememos.com/docs">Docs</a>
2023-10-25 07:43:52 +08:00
<a href="https://demo.usememos.com/">Live Demo</a>
<p>
<a href="https://hub.docker.com/r/neosmemo/memos"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/neosmemo/memos.svg"/></a>
<a href="https://discord.gg/tfPJa4UmAv"><img alt="Discord" src="https://img.shields.io/badge/discord-chat-5865f2?logo=discord&logoColor=f5f5f5" /></a>
</p>
2022-01-17 08:42:36 +08:00
2024-01-18 19:06:49 +08:00
![demo](https://www.usememos.com/demo.png)
2024-09-25 19:47:12 +08:00
## Main Features
2024-09-25 19:47:12 +08:00
- **Privacy First** 🏠: Take control of your data. All runtime data is securely stored in your local database.
- **Create at Speed** ✍️: Save content as plain text for quick access, with Markdown support for fast formatting and easy sharing.
- **Lightweight but Powerful** 🤲: Built with Go, React.js, and a compact architecture, our application delivers powerful performance in a lightweight package.
- **Customizable** 🧩: Easily customize your server name, icon, description, system style, and execution scripts to make it uniquely yours.
- **Open Source** 🦦: Memos embraces the future of open source, with all code available on GitHub for transparency and collaboration.
- **Free to Use** 💸: Enjoy all features completely free, with no charges ever for any content.
2022-04-03 21:54:54 +08:00
2023-03-05 21:33:57 +08:00
## Deploy with Docker in seconds
2023-03-05 21:33:57 +08:00
```bash
2024-01-18 19:06:49 +08:00
docker run -d --name memos -p 5230:5230 -v ~/.memos/:/var/opt/memos neosmemo/memos:stable
2022-05-01 11:06:29 +08:00
```
2022-04-03 21:54:54 +08:00
2024-05-25 11:01:54 +08:00
> [!NOTE]
2024-07-28 17:41:47 +08:00
> This command is only applicable for Unix/Linux systems. For Windows, please refer to the detailed [documentation](https://www.usememos.com/docs/install/container-install#docker-on-windows).
2024-05-25 11:01:54 +08:00
>
2023-03-05 21:33:57 +08:00
> The `~/.memos/` directory will be used as the data directory on your local machine, while `/var/opt/memos` is the directory of the volume in Docker and should not be modified.
2023-10-26 09:00:36 +08:00
Learn more about [other installation methods](https://www.usememos.com/docs/install).
2023-03-05 21:33:57 +08:00
## Contribution
2022-04-03 22:14:43 +08:00
2023-03-05 21:33:57 +08:00
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. We greatly appreciate any contributions you make. Thank you for being a part of our community! 🥰
2022-04-03 22:14:43 +08:00
2024-09-02 09:20:14 +08:00
## Sponsorship
2024-09-02 21:25:42 +08:00
If you find Memos helpful, please consider sponsoring us. Your support will help us to continue developing and maintaining the project.
2024-09-02 09:20:14 +08:00
2024-09-02 21:25:42 +08:00
❤️ Thanks to the following sponsors and backers: **[yourselfhosted](https://github.com/yourselfhosted)**, **[Burning_Wipf](https://github.com/KUKARAF)**, _[...see more](https://github.com/sponsors/usememos)_.
2024-09-02 09:20:14 +08:00
2022-08-22 20:52:54 +08:00
## Star history
2022-02-04 22:00:13 +08:00
2022-07-24 13:37:07 +08:00
[![Star History Chart](https://api.star-history.com/svg?repos=usememos/memos&type=Date)](https://star-history.com/#usememos/memos&Date)
2024-09-25 19:47:12 +08:00
## Other Projects
2024-02-23 08:25:54 +08:00
- [**Slash**](https://github.com/yourselfhosted/slash): An open source, self-hosted bookmarks and link sharing platform. Save and share your links very easily.
2024-06-06 23:09:13 +08:00
- [**Gomark**](https://github.com/usememos/gomark): A markdown parser written in Go for Memos. And its [WebAssembly version](https://github.com/usememos/gomark-wasm) is also available.