Complete Docker-based Cinny deployment with SSL certificate management for production and development environments.

Automatic SSL certificate management from Let's Encrypt for production deployments. Provides seamless HTTPS integration for Docker containers using nginx-proxy and acme-companion. Learn more about Let's Encrypt Manager configuration.

Local domain stack with trusted self-signed certificates for virtual network deployments. Includes private CA management and local DNS resolution for development environments. Learn more about Step CA Manager configuration.

Matrix homeserver implementation providing the backend infrastructure for Cinny client. Includes PostgreSQL backend and multiple deployment configurations. Learn more about Matrix Synapse configuration.

Lightweight Rust-based Matrix homeserver with minimal resource usage and RocksDB backend. Provides complete Matrix federation support with OIDC integration capabilities and modular deployment configurations. Learn more about Conduit configuration.

Modular Docker Compose configuration system for Cinny client with support for multiple environments and simplified configuration. Provides complete Matrix web client deployment with lightweight, user-friendly interface for development and production. Learn more about Cinny configuration.

Each component has its own README with detailed setup instructions. Choose the certificate management solution that fits your deployment scenario.

1. Choose SSL Management:

   • Production: Use Let's Encrypt Manager
   • Development: Use Step CA Manager

2. Deploy Matrix Backend:

   • Set up Synapse homeserver (full-featured, PostgreSQL-based)
   • Or set up Conduit homeserver (lightweight, Rust-based)

3. Deploy Cinny:

   • Configure Cinny client to connect to your Matrix homeserver

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Cinny │────│ Matrix Homeserver│────│ Database │
│ (Frontend) │ │ (Synapse/Conduit)│ │(PostgreSQL/ │
└─────────────────┘ └─────────────────┘ │ RocksDB) │
 │ └─────────────────┘
 │
 ┌─────────────────┐
 │ SSL Manager │
 │ (Let's Encrypt/ │
 │ Step CA) │
 └─────────────────┘

• Docker & Docker Compose
• Domain name (for production deployments)
• Email address (for Let's Encrypt)
• yq tool for configuration building

All services use modular Docker Compose configurations with:

• Base components: Core service definitions
• Environment components: Development, production, SSL configurations
• Build system: Automatic generation of deployment combinations

# Cinny with port forwarding
cd src/cinny/build/forwarding/base/
docker-compose up -d
# Synapse with port forwarding
cd src/matrix/synapse/build/forwarding/base/
docker-compose up -d
# Conduit with port forwarding
cd src/matrix/conduit/src/conduit/build/forwarding/base/
docker-compose up -d

# Cinny with Let's Encrypt SSL
cd src/cinny/build/letsencrypt/base/
docker-compose up -d
# Synapse with Let's Encrypt SSL
cd src/matrix/synapse/build/letsencrypt/base/
docker-compose up -d
# Conduit with Let's Encrypt SSL
cd src/matrix/conduit/src/conduit/build/letsencrypt/base/
docker-compose up -d

# Cinny in DevContainer
cd src/cinny/build/devcontainer/base/
docker-compose up -d
# Synapse in DevContainer
cd src/matrix/synapse/build/devcontainer/base/
docker-compose up -d
# Conduit in DevContainer
cd src/matrix/conduit/src/conduit/build/devcontainer/base/
docker-compose up -d

• SSL/TLS Encryption: Automatic certificate management
• Matrix Authentication: Built-in Matrix homeserver authentication
• Network Isolation: Docker network segmentation
• Secret Management: Environment-based configuration

• SSL Certificate Issues: Check Let's Encrypt/Step CA configuration
• Network Connectivity: Ensure proper Docker network configuration
• Database Connection: Check PostgreSQL connectivity for Synapse

# Cinny logs
docker logs cinny
# Synapse logs
docker logs matrix
# Conduit logs
docker logs conduit
# SSL automation logs
docker logs letsencrypt-manager # or step-ca-manager

• Cinny Configuration
• Matrix Synapse Setup
• Matrix Conduit Setup
• SSL Automation

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test configurations
5. Submit a pull request

This project is dual-licensed under:

• Apache License 2.0
• MIT License

• Matrix.org - Open network for secure, decentralized communication
• Cinny - Simple, elegant and secure Matrix client
• Synapse - Matrix homeserver implementation
• Conduit - Lightweight Matrix homeserver written in Rust