Complete Docker-based FluffyChat deployment with SSL certificate management for production and development environments. FluffyChat is a simple and modern Matrix client that provides a clean alternative to Element with fewer dependencies and a streamlined user experience.
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 FluffyChat 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 FluffyChat client with support for multiple environments. Provides complete Matrix web client deployment with customizable configurations for development and production. Learn more about FluffyChat configuration.
Each component has its own README with detailed setup instructions. Choose the certificate management solution that fits your deployment scenario.
-
Choose SSL Management:
- Production: Use Let's Encrypt Manager
- Development: Use Step CA Manager
-
Deploy Matrix Backend:
- Set up Synapse homeserver (full-featured, PostgreSQL-based)
- Or set up Conduit homeserver (lightweight, Rust-based)
-
Deploy FluffyChat:
- Configure FluffyChat client to connect to your Matrix homeserver
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ FluffyChat │────│ Matrix Server │────│ Database │
│ (Frontend) │ │ (Synapse/ │ │ (PostgreSQL/ │
└─────────────────┘ │ Conduit) │ │ RocksDB) │
│ └─────────────────┘ └─────────────────┘
│ │
┌─────────────────┐
│ SSL Manager │
│ (Let's Encrypt/ │
│ Step CA) │
└─────────────────┘- Docker & Docker Compose
- Domain name (for production deployments)
- Email address (for Let's Encrypt)
yqtool 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
# FluffyChat with port forwarding
cd src/fluffychat/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# FluffyChat with Let's Encrypt SSL
cd src/fluffychat/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# FluffyChat in DevContainer
cd src/fluffychat/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
- Network Isolation: Docker network segmentation
- Secret Management: Environment-based configuration
- Access Control: Matrix-based permissions
- SSL Certificate Issues: Check Let's Encrypt/Step CA configuration
- Network Connectivity: Ensure proper Docker network configuration
- Database Connection: Check PostgreSQL connectivity for Synapse
# FluffyChat logs
docker logs fluffychat
# Synapse logs
docker logs matrix
# Conduit logs
docker logs conduit- Fork the repository
- Create a feature branch
- Make your changes
- Test configurations
- Submit a pull request
This project is dual-licensed under:
- Matrix.org - Open network for secure, decentralized communication
- FluffyChat - Simple and modern Matrix client
- Synapse - Matrix homeserver implementation
- Conduit - Lightweight Matrix homeserver written in Rust