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 9, Rocky Linux 9, or Ubuntu 22.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

Fresh Server Required

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.5

• PHP 8.5 with all required extensions:
  • openSSL, PDO, MySQLi, mbstring
  • Tokenizer, XML, cURL, Zip
  • Iconv, fileinfo, IMAP
  • GD, BCMath, Ioncube
• PHP-FPM with default configuration

Memory Optimization

PHP-FPM is installed with default memory_limit. For high-volume sending, you may want to increase this in /etc/php.ini after installation, then restart PHP-FPM with systemctl restart php-fpm.

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

Queue Driver Configuration

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:

═══════════════════════════════════════════════════════════════
  Mumara Campaigns Installation Complete!
═══════════════════════════════════════════════════════════════

  Your Mumara Campaigns is ready at: https://campaigns.yourdomain.com

  Login Credentials:
  - Email: admin@yourdomain.com
  - Password: [auto-generated]

  Database Details:
  - Database: mumara_db
  - Username: mumara_user
  - Password: [auto-generated]

  These credentials are saved to: /root/.mumara-credentials

═══════════════════════════════════════════════════════════════

No Web Installer Needed

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.

View Saved Credentials

Your login and database credentials are saved for future reference:

cat /root/.mumara-credentials

Login to Your Dashboard

1. Open your browser and navigate to your domain (e.g., https://campaigns.yourdomain.com)
2. Enter the admin email and password from the installation output
3. Navigate to Settings → Application Settings → General
4. Set the Queue Driver to Supervisor
5. 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

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/httpd status
systemctl status httpd

# Check PHP-FPM status
systemctl status php-fpm

# 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
cat /root/.mumara-credentials

# Stop services
systemctl stop httpd
supervisorctl stop all

# Remove application files
rm -rf /var/www/your-domain.com

# Remove database (use credentials from above)
mysql -e "DROP DATABASE mumara_db; DROP USER 'mumara_user'@'localhost';"

# Remove credentials file
rm /root/.mumara-credentials

danger

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