BoxMta Documentation
Complete guide to setting up and managing your own mail server with BoxMta.
Important: BoxMta requires a fresh Ubuntu 18.04, 20.04, 22.04, 24.04 VPS with at least 1GB RAM and a valid domain name.
System Requirements
Minimum Requirements
- Ubuntu 18.04, 20.04, 22.04, 24.04 LTS
- 1GB RAM minimum
- 10GB disk space
- Root access
Recommended
- 2GB+ RAM
- SSD/HDD storage
- Static IP address
Installation
Step 1: Prepare Your Server
Connect to your Ubuntu VPS via SSH and update the system:
sudo apt update && sudo apt upgrade -y
Step 2: Run the Installation Script
Execute the BoxMta installation script:
curl -s https://boxmta.iiniit.com/install.sh | sudo bash
Step 3: Follow the Setup Wizard
The installation script will prompt you for:
- Your domain name (e.g., example.com)
- Enter hostname (e.g., mail.example.com)
- Enter domain for management portal (e.g., box.example.com)
- Enter domain for webmail (e.g., webmail.example.com)
The installation typically takes 5-10 minutes depending on your server specifications.
DNS Configuration
Configure these DNS records for your domain:
| Type | Name | Value | Priority |
|---|---|---|---|
| A | box | YOUR_SERVER_IP | - |
| A | webmail | YOUR_SERVER_IP | - |
| A | YOUR_SERVER_IP | - | |
| MX | @ | mail.example.com | 10 |
| TXT | @ | v=spf1 a mx ip4:000.000.000.000 ~all | - |
| TXT | _dmarc | v=DMARC1; p=none; rua=mailto:[email protected] | - |
| TXT | mail._domainkey | Past your dkim value which you will get after installation | - |
Management Panel
Access your BoxMta management panel at https://box.example.com
Features
- Domain management
- User account creation
- Alias management
Clean, intuitive interface for managing your mail server
Webmail Access
Users can access their email at https://webmail.example.com
Webmail Features
- Responsive design
- Rich text editor
- Attachment support
- Folder management
- Search functionality
Modern webmail client accessible from any device
Troubleshooting
Common Issues
Cannot access management panel
Check if the DNS records are properly configured and propagated.
nslookup box.example.com
Emails not being delivered
Verify your server's IP is not blacklisted and SPF records are correct.
sudo tail -f /var/log/mail.log
Need Help? Join our community forum or check the GitHub issues for additional support.