MailBridge

Documentation

Complete guide for deploying and managing MailBridge enterprise email routing system.

Overview

MailBridge is an enterprise-grade email smart routing and distribution system. Companies expose only a unified email address externally, and the system automatically synchronizes emails locally through IMAP protocol and intelligently distributes them to appropriate employees.

Key Features

  • Unified external email image
  • Intelligent email distribution to improve response efficiency
  • Employees use familiar email clients with zero learning cost
  • Support for Windows service mode operation
  • Support for command-line console mode operation

Current Version

Version 1.1.0

Installation and Usage

Console Mode (Recommended for development and testing)

# Basic run
MailBridge.exe

# Or explicitly specify console mode
MailBridge.exe run

# Enable verbose logging
MailBridge.exe run --verbose

In console mode, the program will display startup information and prompt "Press Ctrl+C to exit". Press Ctrl+C to gracefully stop the program.

Windows Service Mode (Recommended for production)

Install Service

MailBridge.exe install

After successful installation, it will display: 

MailBridge service installed successfully!
You can use the following commands to manage the service:
  Start service: net start MailBridge
  Stop service: net stop MailBridge
  Uninstall service: MailBridge.exe --uninstall

Service Management

# Start service
MailBridge.exe start

# Stop service
MailBridge.exe stop

# Check service status
MailBridge.exe status

# Uninstall service
MailBridge.exe uninstall

Manage Service with System Commands

# Start service
net start MailBridge

# Stop service
net stop MailBridge

# Check service status
sc query MailBridge

Configuration

The program will automatically create a default configuration file database/setting.json on first run.

Web Management Panel

MailBridge provides a comprehensive web-based management interface for system configuration and monitoring. The web panel is accessible through any modern web browser and includes the following features:

MailBridge Web Management Panel Dashboard

MailBridge Web Management Panel Dashboard

Accessing the Web Panel

Once MailBridge is running (either in console or service mode), open your web browser and navigate to: 

http://localhost:1819

Default Credentials:

  • Username: admin
  • Password: 123456

Security Note: For security reasons, the web panel is bound to localhost (127.0.0.1) by default. To access from other machines, you can modify the admin bind address in the web panel settings.

Available Configuration Options

General Settings
  • Company Name: Set your organization's name for display purposes
  • Admin Bind Address: IP address for the web admin server to bind to
  • Admin Port: Port number for the web admin server (default: 1819)
  • Timezone: Configure the system timezone for date/time display
  • Date Format: Customize how dates and times are displayed
  • Privacy Settings: Option to hide external sender addresses from employees
  • SSL Configuration: Enable SSL transmission for internal services
SMTP Configuration
  • SMTP Server Settings: Host, port, credentials, and security options
  • Connection Testing: Test SMTP connection before saving settings
  • Security Options: None, TLS, or SSL encryption
IMAP Configuration
  • IMAP Server Settings: Host, port, credentials, and security options
  • Poll Interval: How often to check for new emails (1-60 minutes)
  • Connection Testing: Test IMAP connection before saving settings
Software Registration
  • Company Information: Register your company details
  • License Key: Enter your 32-character license key for software activation

Configuration Steps

  1. Start MailBridge using either console or service mode
  2. Open your web browser and go to http://localhost:1819
  3. Log in with the default credentials (admin/admin)
  4. Navigate through each section and configure the required settings
  5. Use the "Test Connection" buttons to verify SMTP and IMAP settings
  6. Click "Save Settings" to apply all changes
  7. Restart MailBridge service for some changes to take effect

Note: All configuration changes are saved to the data/setting.json file and persist across program restarts.

System Requirements

Operating System

  • Windows operating system (64-bit)

Mail Server

  • Installed mail server (IMAP and SMTP)

Architecture

MailBridge includes the following core components:

IMAP Poller

Periodically synchronizes emails from corporate mailbox

Intelligent Distribution Engine

Automatically distributes emails to employees according to rules

POP3 Server

Provides email access for employees

SMTP Relay

Handles employee email sending

Web Management Panel

Provides system configuration and management interface

Need Help?

Contact our support team for assistance with deployment and configuration.

Contact Support