lin-snow / Ech0

Preview | Official Site & Documentation | Ech0 Hub # Ech0 > A self-hosted personal microblog where your timeline can be shared, discussed, and fully owned. Tools like Memos are great for capturing quick thoughts. Ech0 is built for what comes next: publishing those ideas to a personal timeline that others can follow and interact with. Run it on your own server, keep full control of your content, and keep a personal space that still feels connected through optional comments and sharing. It stays lightweight, easy to deploy, and fully open-source. **Great fit if you want to:** • run a personal public or semi-public timeline on your own domain • publish short posts, links, and media from one clean interface • keep data ownership while still getting RSS and optional comments • keep a personal space that supports lightweight social interaction without becoming a full social network **Probably not for you if you need:** • a bi-directional knowledge base workflow (for example Obsidian-style PKM) • a team-first collaborative docs workspace (for example Notion-style docs) • a private-only memo app with no publishing or timeline focus --- Table of Contents • Ech0 • Try in 60 Seconds • Why Ech0 • Full Feature List • Quick Deployment • 🐳 Docker Deployment (Recommended) • 🐋 Docker Compose • ☸️ Kubernetes (Helm) • Upgrading • 🔄 Docker • 💎 Docker Compose • ☸️ Kubernetes (Helm) • FAQ • Feedback & Community • Open Source Governance • Project Architecture • Development Guide • Backend Requirements • Frontend Requirements • Start Backend & Frontend • Thanks for Your Support! • Star History • Acknowledgements • Support the Project --- Try in 60 Seconds Then open : • Register your first account. • The first account becomes Owner (admin privileges). • By default, publishing is restricted to privileged accounts. See Quick Deployment for Docker Compose and Helm options. Why Ech0 • 📝 **Built for personal publishing**: Timeline-first microblog flow for thoughts, links, and short writing. • 🤝 **Lightweight social by design**: Posts can be shared and discussed through optional comments and interactions. • 🧘 **Clean reading experience**: Zen-like timeline browsing with minimal distraction. • ⚡ **Markdown and media in one place**: Markdown editor, rich cards, and embedded video support. • 🔒 **Personal first with full ownership**: Best as a personal instance with optional multi-user roles, while staying self-hosted, RSS-ready, and AGPL-3.0 open-source. Full Feature List Expand full capabilities Highlights • ☁️ **Lightweight, Efficient Architecture**: Low resource usage and compact images, suitable from personal servers to ARM devices. • 🚀 **Fast Deployment Experience**: Out-of-the-box Docker deployment from install to first run with a single command. • 📦 **Self-Contained Distribution**: Complete binaries and container images, with no extra runtime dependencies. • 💻 **Cross-Platform Support**: Supports Linux, Windows, and ARM devices (for example, Raspberry Pi). Storage & Data • 🗂️ **VireFS Unified Storage Layer**: Uses **VireFS** to unify mounting and management for local storage and S3-compatible object storage. • ☁️ **S3 Object Storage Support**: Native support for S3-compatible object storage for cloud resource expansion. • 📦 **Data Sovereignty**: Content and metadata remain user-owned and user-controlled, with RSS output support. • 🔄 **Data Migration Workflow**: Supports migration import for historical data and snapshot export for migration and archiving. • 🔐 **Automated Backup System**: Supports export/backup via Web, CLI, and TUI, plus background automatic backups. Writing & Content • ✍️ **Markdown Writing Experience**: A **markdown-it** based editing/rendering engine with plugin extension and live preview. • 🧘 **Zen Mode Immersive Reading**: A minimal-distraction Timeline browsing mode. • 🏷️ **Tag Management System**: Supports tag organization, quick filtering, and precise retrieval. • 🃏 **Rich Media Cards**: Supports card rendering for website links, GitHub projects, and more. • 🎥 **Video Content Parsing**: Supports embedded parsing/display for Bilibili and YouTube videos. Media & Assets • 📁 **Visual File Manager**: Built-in capabilities for file upload, browsing, and asset management. Social & Interaction • 💬 **Built-in Comment System**: Supports comments and moderation configuration. • 🃏 **Content Interaction**: Supports social interactions such as likes and sharing. Auth & Security • 🔑 **OAuth2 / OIDC Authentication**: Supports OAuth2 and OIDC for third-party login integration. • 🙈 **Passkey Passwordless Login**: Supports biometric or hardware security key sign-in. • 🔑 **Access Token Management**: Supports generating and revoking tokens for API calls and third-party integration. • 👤 **Multi-Account Permission Management**: Supports multi-user collaboration and permission control. System & Developer • 🧱 **Busen Data Bus Architecture**: Uses in-house Busen to provide decoupled module communication and reliable message delivery. • 📊 **Structured Logging System**: System logs are standardized in structured format for readability and analysis. • 🖥️ **Real-Time System Log Console**: Built-in web console for live log streams, debugging, and troubleshooting. • 📟 **TUI Management Interface**: Provides a terminal UI, ideal for server-side administration. • 🧰 **CLI Toolchain**: CLI tools for automation and script integration. • 🔗 **Open API & Webhook**: Full API and Webhook support for external integration and automation workflows. Experience • 🌍 **Cross-Device Adaptation**: Responsive design for desktop, tablet, and mobile browsers. • 🌐 **i18n Multi-Language Support**: Multi-language UI switching for different usage scenarios. • 👾 **PWA Support**: Installable as a web app for a more native-like experience. • 🌗 **Themes & Dark Mode**: Supports dark mode and theme extension. License • 🎉 **Fully Open Source**: Released under **AGPL-3.0**, with no tracking, no…