secubox-openwrt/package/secubox/luci-app-mailserver/README.md
CyberMind-FR ded107e408 feat(luci-app-mailserver): Add unified mail server dashboard
All-in-one LuCI interface for:
- Mail server status and control
- User/alias management with modals
- Port status monitoring
- DNS/SSL setup actions
- Webmail configuration
- Mesh backup integration

RPCD handler with 17 methods for full mail management.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-05 10:43:55 +01:00

2.2 KiB

LuCI Mail Server Manager

Unified web dashboard for SecuBox mail server, webmail, and mesh backup.

Features

  • Server Status: Container state, domain, users, storage, SSL, mesh
  • Port Monitoring: SMTP (25), Submission (587), SMTPS (465), IMAPS (993), POP3S (995)
  • User Management: Add/delete mail accounts with mailbox stats
  • Alias Management: Create email forwarding aliases
  • DNS Setup: One-click MX, SPF, DMARC record creation
  • SSL Setup: ACME DNS-01 certificate automation
  • Webmail Integration: Configure Roundcube container
  • Mesh Backup: P2P backup synchronization

Installation

opkg install luci-app-mailserver

Location

Services → Mail Server

RPCD Methods

Method Parameters Description
status - Get server status (state, domain, users, ports, SSL)
user_list - List mail users with mailbox stats
alias_list - List email aliases
webmail_status - Get webmail container status
logs lines Get mail server logs
install - Install mail server container
start - Start mail server
stop - Stop mail server
restart - Restart mail server
user_add email, password Add mail user
user_del email Delete mail user
user_passwd email, password Change user password
alias_add alias, target Add email alias
dns_setup - Create MX/SPF/DMARC records
ssl_setup - Obtain SSL certificate
webmail_configure - Configure Roundcube
mesh_backup - Create mesh backup
mesh_sync mode Sync with mesh (push/pull)

Dashboard Sections

Server Status

  • Container running state
  • Domain FQDN
  • User count
  • Storage usage
  • SSL certificate validity
  • Webmail status
  • Mesh backup status
  • Port status indicators

Quick Actions

  • Start/Stop server
  • Setup DNS records
  • Setup SSL certificate
  • Configure webmail
  • Create mesh backup

Mail Users

  • Email address
  • Mailbox size
  • Message count
  • Delete action

Email Aliases

  • Alias address
  • Forward target

Dependencies

  • secubox-app-mailserver - Backend CLI
  • luci-base - LuCI framework