Introduction

Welcome to the SirrChat documentation! This guide will help you understand and get started with the SirrChat ecosystem.

What is SirrChat?

SirrChat is a revolutionary communication platform that combines enterprise-grade email services with modern blockchain technology. It consists of two main components that work together to provide secure, private, and decentralized communication.

The SirrChat Ecosystem

SirrChat Server

The backend infrastructure - a composable, all-in-one email server with blockchain authentication support.

Key Features:

• Full SMTP/IMAP protocol support
• EVM wallet signature authentication
• Multiple authentication methods (LDAP, PAM, etc.)
• Flexible message processing pipeline
• Production-ready deployment tools
• Multi-database and storage backend support

Learn more about SirrChat →

Sirr App

The user-facing application - a decentralized messaging app with an integrated wallet.

Key Features:

• OpenPGP end-to-end encryption
• No central data storage
• Built-in BNBChain wallet
• Red envelope (crypto gift) feature
• Multi-device synchronization
• Cross-node messaging

Learn more about Sirr →

How They Work Together

┌─────────────────────────────────────────────┐
│           Sirr Mobile/Desktop App           │
│  (User Interface + Encrypted Messaging)     │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
┌─────────────────────────────────────────────┐
│            SirrChat Server                  │
│   (Email Server + Blockchain Auth)          │
└──────────────────┬──────────────────────────┘
                   │
        ┌──────────┴──────────┐
        ▼                     ▼
┌──────────────┐      ┌──────────────┐
│   Database   │      │  Blockchain  │
│ (PostgreSQL, │      │ (BSC, ETH,   │
│  MySQL, etc) │      │  etc)        │
└──────────────┘      └──────────────┘

Why Choose SirrChat?

For Users

• Privacy First: End-to-end encryption ensures only you can read your messages
• No Surveillance: Decentralized architecture means no central authority can monitor you
• Wallet Integration: Send crypto as easily as sending messages
• Censorship Resistant: Distributed nodes make blocking nearly impossible
• Open Source: Fully transparent and auditable code

For System Administrators

• Easy Deployment: One-click installation script
• Flexible Configuration: Simple, readable configuration format
• Production Ready: Battle-tested with comprehensive monitoring
• Multiple Storage Options: SQLite, PostgreSQL, MySQL, S3
• Automatic TLS: Integrated ACME certificate management

For Developers

• Modular Architecture: Easy to extend with custom modules
• Clean API: Well-documented interfaces
• Active Development: Regular updates and improvements
• Open Source: GPL 3.0 license
• Developer Friendly: Comprehensive documentation and examples

Core Principles

1. Privacy & Security

• End-to-end encryption using proven OpenPGP standard
• Local data storage - you control your data
• No tracking or analytics
• Open source for full transparency

2. Decentralization

• No central servers storing user data
• Anyone can run their own node
• Cross-node communication without intermediaries
• Resistant to censorship and shutdown

3. User Sovereignty

• You own your identity (your wallet address)
• You control your private keys
• You choose where your data is stored
• No vendor lock-in

4. Accessibility

• Easy to use for non-technical users
• Familiar email-like experience
• Multi-platform support (iOS, Android, Desktop)
• Comprehensive documentation

Use Cases

Personal Communication

Replace traditional email and messaging apps with a private, secure alternative.

Enterprise Communication

Deploy your own email and messaging infrastructure with blockchain authentication.

Crypto Communities

Built-in wallet makes it easy to combine communication with crypto transactions.

Journalists & Activists

Censorship-resistant platform for sensitive communications.

Development & Testing

Perfect development environment with local database support.

Getting Started

Choose your path:

For Users

1. Download Sirr App
2. Create Your Account
3. Start Messaging

For System Administrators

1. Install SirrChat Server
2. Configure Your Server
3. Deploy to Production

For Developers

1. Understand the Architecture
2. Explore the Modules
3. Read the API Documentation

Community

Join our growing community:

• GitHub: mail-chat-chain/mailchatd
• Twitter: Follow us for updates
• Documentation: You're reading it!

Support

Need help?

• Browse this documentation
• Check the FAQ
• Open an issue on GitHub
• Join our community chat

---

Ready to get started? Head to the Quick Start Guide or dive into SirrChat or Sirr documentation.