[PR #295] [CLOSED] feat: add BillionMail email server template #343

Closed
opened 2025-11-22 20:35:51 -06:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/Dokploy/templates/pull/295
Author: @vaayne
Created: 8/20/2025
Status: Closed

Base: mainHead: main


📝 Commits (3)

  • d22d07a feat: add BillionMail email server template
  • 68420df process meta.json
  • ef51eea Fix BillionMail Docker volume mounting issues

📊 Changes

4 files changed (+3332 additions, -2255 deletions)

View changed files

blueprints/billionmail/billionmail.svg (+8 -0)
blueprints/billionmail/docker-compose.yml (+212 -0)
blueprints/billionmail/template.toml (+38 -0)
📝 meta.json (+3074 -2255)

📄 Description

Summary

Add comprehensive BillionMail email server template for Dokploy deployment.

📧 What is BillionMail?

BillionMail is a complete email server solution that provides a full-featured email infrastructure with modern security and spam filtering capabilities.

🚀 Features

  • Complete Email Stack: Postfix (SMTP), Dovecot (IMAP/POP3), Rspamd (spam filtering)
  • Database & Cache: PostgreSQL for reliable data storage, Redis for performance
  • Web Interface: Roundcube webmail client + management dashboard
  • Security: Fail2ban protection with automated IP blocking
  • Self-hosted: Full control over email infrastructure
  • Production Ready: Based on proven email server components

📦 Template Structure

  • docker-compose.yml: Dokploy-compatible multi-service configuration
  • template.toml: Domain, environment variables, and mount configuration
  • billionmail.svg: Custom template logo
  • meta.json: Template metadata and description

Dokploy Compatibility

  • Removed host port bindings (uses container ports only)
  • Removed custom network definitions (Dokploy handles networking)
  • Converted bind mounts to named volumes
  • Removed container names to avoid conflicts
  • Follows all guidelines from README.md
  • Includes proper environment variable configuration
  • Auto-generated secure passwords using helpers
  • Domain configuration for web access

🔧 Configuration

The template includes:

  • Auto-generated database and Redis passwords
  • Domain configuration for web access
  • Timezone setting (defaults to UTC)
  • Configurable retention days for logs/data
  • Redis configuration script mount for authentication

📋 Services Included

  1. PostgreSQL - Primary database
  2. Redis - Caching and session storage
  3. Rspamd - Advanced spam filtering
  4. Dovecot - IMAP/POP3 email retrieval
  5. Postfix - SMTP email delivery
  6. Roundcube - Web-based email client
  7. BillionMail Core - Management interface with fail2ban

🎯 Use Cases

  • Personal email server
  • Small business email infrastructure
  • Organization email hosting
  • Privacy-focused email solution
  • Migration from hosted email services

🧪 Testing

  • Template follows Dokploy best practices
  • All services properly configured with dependencies
  • Environment variables correctly templated
  • Volume mounts converted to named volumes
  • Network isolation handled by Dokploy

This template enables users to deploy a complete, production-ready email server infrastructure with just a few clicks in Dokploy.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/Dokploy/templates/pull/295 **Author:** [@vaayne](https://github.com/vaayne) **Created:** 8/20/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (3) - [`d22d07a`](https://github.com/Dokploy/templates/commit/d22d07a6f35e562b599816ddc635b7b4cbc1df99) ✨ feat: add BillionMail email server template - [`68420df`](https://github.com/Dokploy/templates/commit/68420df6366e1ec3b7891c210261acda32b09ed5) process meta.json - [`ef51eea`](https://github.com/Dokploy/templates/commit/ef51eea43337d41e0367b9451516ded08b0286de) Fix BillionMail Docker volume mounting issues ### 📊 Changes **4 files changed** (+3332 additions, -2255 deletions) <details> <summary>View changed files</summary> ➕ `blueprints/billionmail/billionmail.svg` (+8 -0) ➕ `blueprints/billionmail/docker-compose.yml` (+212 -0) ➕ `blueprints/billionmail/template.toml` (+38 -0) 📝 `meta.json` (+3074 -2255) </details> ### 📄 Description ## Summary Add comprehensive BillionMail email server template for Dokploy deployment. ## 📧 What is BillionMail? BillionMail is a complete email server solution that provides a full-featured email infrastructure with modern security and spam filtering capabilities. ## 🚀 Features - **Complete Email Stack**: Postfix (SMTP), Dovecot (IMAP/POP3), Rspamd (spam filtering) - **Database & Cache**: PostgreSQL for reliable data storage, Redis for performance - **Web Interface**: Roundcube webmail client + management dashboard - **Security**: Fail2ban protection with automated IP blocking - **Self-hosted**: Full control over email infrastructure - **Production Ready**: Based on proven email server components ## 📦 Template Structure - `docker-compose.yml`: Dokploy-compatible multi-service configuration - `template.toml`: Domain, environment variables, and mount configuration - `billionmail.svg`: Custom template logo - `meta.json`: Template metadata and description ## ✅ Dokploy Compatibility - ✅ Removed host port bindings (uses container ports only) - ✅ Removed custom network definitions (Dokploy handles networking) - ✅ Converted bind mounts to named volumes - ✅ Removed container names to avoid conflicts - ✅ Follows all guidelines from README.md - ✅ Includes proper environment variable configuration - ✅ Auto-generated secure passwords using helpers - ✅ Domain configuration for web access ## 🔧 Configuration The template includes: - Auto-generated database and Redis passwords - Domain configuration for web access - Timezone setting (defaults to UTC) - Configurable retention days for logs/data - Redis configuration script mount for authentication ## 📋 Services Included 1. **PostgreSQL** - Primary database 2. **Redis** - Caching and session storage 3. **Rspamd** - Advanced spam filtering 4. **Dovecot** - IMAP/POP3 email retrieval 5. **Postfix** - SMTP email delivery 6. **Roundcube** - Web-based email client 7. **BillionMail Core** - Management interface with fail2ban ## 🎯 Use Cases - Personal email server - Small business email infrastructure - Organization email hosting - Privacy-focused email solution - Migration from hosted email services ## 🧪 Testing - Template follows Dokploy best practices - All services properly configured with dependencies - Environment variables correctly templated - Volume mounts converted to named volumes - Network isolation handled by Dokploy This template enables users to deploy a complete, production-ready email server infrastructure with just a few clicks in Dokploy. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2025-11-22 20:35:51 -06:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/templates#343