@@ -35,53 +45,42 @@ Memos is a lightweight, self-hosted alternative to cloud-based note-taking servi
...
@@ -35,53 +45,42 @@ Memos is a lightweight, self-hosted alternative to cloud-based note-taking servi
## Key Features
## Key Features
### Data Privacy and Security
### Privacy & Security
-**Complete Data Ownership**: All application data is stored locally in your chosen database
-**Complete Data Ownership** — All data stored locally in your chosen database
-**Self-Hosted Architecture**: Full control over your data infrastructure and access policies
-**Self-Hosted Architecture** — Full control over infrastructure and access policies
-**No External Dependencies**: Runtime operations require no third-party services or cloud connections
-**No External Dependencies** — Zero third-party services or cloud connections required
### Content Creation and Management
### Content Creation
-**Plain Text Efficiency**: Streamlined text input with immediate save functionality
-**Instant Save** — Streamlined plain text input with automatic persistence
-**Advanced Markdown Support**: Comprehensive Markdown rendering with syntax highlighting
-**Rich Markdown Support** — Full Markdown rendering with syntax highlighting
-**Rich Media Integration**: Support for images, links, and embedded content
-**Media Integration** — Native support for images, links, and embedded content
### Technical Excellence
### Performance & Technology
-**High-Performance Backend**: Built with Go for optimal resource utilization and scalability
-**High-Performance Backend** — Built with Go for optimal resource utilization
-**Modern Frontend**: React.js-based user interface with responsive design
-**Modern React Frontend** — Responsive, intuitive user interface
-**Lightweight Deployment**: Minimal system requirements with efficient resource consumption
-**Lightweight Deployment** — Minimal system requirements, maximum efficiency
-**Cross-Platform Compatibility**: Supports Linux, macOS, Windows, and containerized environments
-**Cross-Platform** — Linux, macOS, Windows, and containerized environments
### Customization and Extensibility
### Customization
-**Configurable Interface**: Customizable server branding, themes, and user interface elements
-**Configurable Interface** — Custom branding, themes, and UI elements
-**API-First Design**: RESTful API with comprehensive documentation for third-party integrations
-**API-First Design** — RESTful API for seamless third-party integrations
-**Multi-Database Support**: Compatible with SQLite, PostgreSQL, and MySQL databases
-**Multi-Database Support** — SQLite, PostgreSQL, and MySQL compatibility
### Cost-Effective Solution
### Cost-Effective
-**Open Source License**: MIT licensed with full source code availability
-**Open Source (MIT)** — Full source code availability with permissive licensing
-**Zero Licensing Costs**: No subscription fees, usage limits, or premium tiers
-**Zero Subscription Fees** — No usage limits, premium tiers, or hidden costs
-**Community-Driven Development**: Active community contribution and transparent development process
-**Community-Driven** — Transparent development with active community support
## Quick Start
## Quick Start
### Prerequisites
Get Memos running in under 1 minutes with Docker:
-[Docker](https://www.docker.com/) or Docker Compose installed on your system
- Minimum 512MB RAM and 1GB available disk space
### Docker Deployment
Deploy Memos in production mode using Docker:
```bash
```bash
# Create data directory
mkdir-p ~/.memos
# Run Memos container
docker run -d\
docker run -d\
--name memos \
--name memos \
--restart unless-stopped \
--restart unless-stopped \
...
@@ -90,134 +89,46 @@ docker run -d \
...
@@ -90,134 +89,46 @@ docker run -d \
neosmemo/memos:stable
neosmemo/memos:stable
```
```
Access the application at `http://localhost:5230` and complete the initial setup process.
Access Memos at `http://localhost:5230` and complete the initial setup.
### Docker Compose Deployment
For advanced configurations, use Docker Compose:
```yaml
# docker-compose.yml
version:"3.8"
services:
memos:
image:neosmemo/memos:stable
container_name:memos
restart:unless-stopped
ports:
-"5230:5230"
volumes:
-./data:/var/opt/memos
environment:
-MEMOS_MODE=prod
-MEMOS_PORT=5230
```
Deploy with:
```bash
docker-compose up -d
```
> **Note**: The data directory (`~/.memos/` or `./data/`) stores all application data including the database, uploaded files, and configuration. Ensure this directory is included in your backup strategy.
>
> **Platform Compatibility**: The above commands are optimized for Unix-like systems (Linux, macOS). For Windows deployments, please refer to the [Windows-specific documentation](https://www.usememos.com/docs/install/container-install#docker-on-windows).
## Installation Methods
Memos supports multiple installation approaches to accommodate different deployment scenarios:
### Container Deployment
-**Docker Hub**: Official images available at `neosmemo/memos`
-**GitHub Container Registry**: Alternative registry with the same image versions
-**Kubernetes**: Helm charts and YAML manifests for cluster deployments
### Binary Installation
-**Pre-compiled Binaries**: Available for Linux, macOS, and Windows on the [releases page](https://github.com/usememos/memos/releases)
### Source Installation
**Alternative methods**: For Docker Compose, Kubernetes, binary installation, or building from source, see our [Installation Guide](https://www.usememos.com/docs/install).
-**Go Build**: Compile from source using Go 1.24 or later
**Pro Tip**: The data directory stores all your notes, uploads, and settings. Include it in your backup strategy!
-**Development Mode**: Local development setup with hot reloading
For detailed installation instructions, refer to the [comprehensive installation guide](https://www.usememos.com/docs/install).
## Sponsors
## Development Setup
Memos is made possible by the generous support of our sponsors. Their contributions help ensure the project's continued development, maintenance, and growth.
Memos is an open-source project that welcomes contributions from developers, designers, and users worldwide. We maintain a collaborative and inclusive development environment that values quality, innovation, and community feedback.
Memos welcomes contributions from developers, designers, and users worldwide. We value quality, innovation, and community feedback.
### Ways to Contribute
**Ways to Contribute:**
-**Code Contributions**: Bug fixes, feature implementations, and performance improvements
Memos is released under the MIT License, providing maximum flexibility for both personal and commercial use. This license allows for:
## License
-**Commercial Use**: Deploy Memos in commercial environments without licensing fees
-**Modification**: Adapt and customize the codebase for specific requirements
-**Distribution**: Share modified versions while maintaining license attribution
-**Private Use**: Use Memos internally without disclosure requirements
See the [LICENSE](./LICENSE) file for complete licensing terms.
## Project Status
> **Development Status**: Memos is actively maintained and under continuous development. While the core functionality is stable and production-ready, users should expect regular updates, feature additions, and potential breaking changes as the project evolves.
Memos is released under the [MIT License](./LICENSE).
>
> **Version Compatibility**: We maintain backward compatibility for data storage and API interfaces where possible. Migration guides are provided for major version transitions.
boojack <stevenlgtm@gmail.com>