Auto-Installer
The auto-installer provides a fully automated solution for setting up Mumara Campaigns on a fresh server. It handles all server configuration, database setup, and application installation automatically — no web installer required.
Prerequisites
Before running the auto-installer, ensure you have:
- Fresh server: Clean VPS or dedicated server running AlmaLinux 10 (recommended), AlmaLinux 8/9, Rocky Linux 8/9, CentOS 7/8, or Ubuntu 20.04/22.04/24.04
- Root access: SSH access with root privileges
- Domain configured: A domain/subdomain pointing to your server's IP address
- License key: Valid Mumara Campaigns license from your purchase
The auto-installer is designed for clean server installations. Running it on a server with existing web applications may cause conflicts.
Installation Command
Connect to your server via SSH as root and run:
cd /home && curl -o installer -L https://dl.mumara.com/campaigns/installer && sh installer
Installation Prompts
The installer will interactively ask for:
| Prompt | Description | Example |
|---|---|---|
| Your Name | Admin account display name | John Smith |
| Domain Name | Your domain/subdomain | campaigns.yourdomain.com |
| License Key | Your Mumara Campaigns license | XXXX-XXXX-XXXX-XXXX |
| SSL Setup | Configure Let's Encrypt SSL | yes or no |
What the Auto-Installer Configures
The auto-installer sets up your complete environment automatically:
Web Server (Apache/httpd)
- Apache (httpd) with optimized configuration
- Virtual host for your domain
- SSL/TLS with Let's Encrypt (if selected)
- Security headers and best practices
PHP 8.4
- PHP 8.4 with all required extensions:
- openSSL, PDO, MySQLi, mbstring
- Tokenizer, XML, cURL, Zip
- Iconv, fileinfo, IMAP
- GD, BCMath, Ioncube
- mod_php (Apache) or PHP-FPM (Nginx) with default configuration
PHP is installed with default memory_limit. For high-volume sending, you may want to increase this in your php.ini after installation, then restart the web server.
Database (MariaDB)
- Latest MariaDB version
- Default configuration
- Dedicated database created automatically
- Secure user credentials generated
Mumara Campaigns Files
- Downloads latest stable release
- Extracts to
/var/www/your-domain.com/public_html - Environment file configured automatically
- Admin account created with your provided name
Cron Jobs
- Laravel scheduler configured
- Runs every minute automatically
Queue Workers (Supervisor)
- Supervisor installed and configured
- Queue workers auto-start on boot
After installation, navigate to Settings → Application Settings → General and set the Queue Driver to Supervisor to ensure queues are processed by Supervisor workers.
Installation Complete
Once the installer finishes, everything is ready to use. You'll see output similar to:
####################################################################
##################### Credentials to be copied #####################
####################################################################
# Mumara Database Details
Database: [auto-generated]
DB User : [auto-generated]
DB Password: [auto-generated]
# Mumara Login Details
Login URL: https://campaigns.yourdomain.com
Login Email: admin@yourdomain.com
Password: [auto-generated]
# MySQL Details
MySQL root password: [auto-generated]
####################################################################
##################### Credentials to be copied #####################
####################################################################
The credentials are only shown once in the terminal output. Copy and save them immediately before closing the SSH session.
Unlike Quick Install or Custom Install, the auto-installer completes the entire setup. Simply log in to your Mumara Campaigns dashboard using the credentials shown.
Login to Your Dashboard
- Open your browser and navigate to your domain (e.g.,
https://campaigns.yourdomain.com) - Enter the admin email and password from the installation output
- Navigate to Settings → Application Settings → General
- Set the Queue Driver to Supervisor
- Start using Mumara Campaigns!
Queue Driver Options
| Option | Description | Use Case |
|---|---|---|
| Realtime | Processes jobs immediately in the request | Very small usage only. Not recommended for production as it blocks the web request. |
| Cronjob | Processes jobs via scheduled cron task | Moderate usage without Supervisor access |
| Supervisor | Processes jobs via Supervisor workers | Recommended for production. Requires Supervisor to be configured and running. |
Realtime mode is dangerous for any significant email volume as it processes everything synchronously, blocking the user interface and potentially causing timeouts.
Troubleshooting
Installation Fails to Start
If the script doesn't run:
# Check internet connectivity
ping -c 3 dl.mumara.com
# Try downloading separately
cd /home
curl -o installer -L https://dl.mumara.com/campaigns/installer
chmod +x installer
./installer
Port Already in Use
If port 80 or 443 is already in use by another service:
# Check what's using the port
lsof -i :80
lsof -i :443
# Stop conflicting services (e.g., nginx if installed)
systemctl stop nginx
SSL Certificate Issues
If Let's Encrypt fails:
- Ensure your domain's DNS A record points to the server IP
- Wait for DNS propagation (can take up to 24-48 hours)
- Verify port 80 is accessible from the internet
# Test DNS resolution
dig +short your-domain.com
# Re-run certbot manually
certbot --apache -d your-domain.com
View Installation Logs
# Check Apache status
systemctl status httpd # RHEL/AlmaLinux
systemctl status apache2 # Ubuntu/Debian
# Check MariaDB status
systemctl status mariadb
# View Mumara logs
tail -f /var/www/your-domain.com/public_html/storage/logs/laravel.log
Uninstallation
To remove Mumara Campaigns installed via auto-installer:
# Get database credentials from .env
cat /var/www/your-domain.com/public_html/.env | grep DB_
# Stop services
systemctl stop httpd # or apache2 on Ubuntu
supervisorctl stop all
# Remove application files
rm -rf /var/www/your-domain.com
# Remove database (use credentials from .env above)
mariadb -e "DROP DATABASE mumara_db; DROP USER 'mumara_user'@'localhost';"
This permanently deletes all data including contacts, campaigns, and statistics. Create backups before uninstalling.
Next Steps
Your Mumara Campaigns is ready to use:
- Initial Setup - Configure sending domains and SMTP
- User Interface - Learn the dashboard