Initial Setup

After installing Mumara Campaigns, follow these steps to configure your email marketing platform.

First Login

1. Navigate to your Mumara Campaigns URL
2. Enter the admin credentials you created during installation
3. Complete two-factor authentication setup (if enabled)

Setup Wizard

On first login, you may see a setup wizard that guides you through:

1. License Activation - Verify your license is active
2. SMTP Configuration - Set up your first sending node
3. Domain Verification - Add and verify a sending domain
4. Admin Profile - Complete your admin profile

Essential Configuration

1. Configure Application Settings

Navigate to Settings > General to configure:

Application Settings

• Application Name: Your brand name (appears in emails and UI)
• Application URL: Your full URL including https://
• Default Timezone: Your preferred timezone
• Default Language: Interface language

Email Settings

• System Email: Address for system notifications
• Support Email: Address displayed to users for support

2. Set Up a Sending Domain

Before sending emails, configure at least one sending domain.

Navigate to Setup > Sending Domains > Add Domain:

1. Enter Domain Name: e.g., mail.yourdomain.com
2. Configure DNS Records:
   • Add the provided SPF record
   • Add the DKIM record
   • Configure DMARC (recommended)
3. Verify Domain: Click verify to check DNS propagation

Best Practice

Use a subdomain for sending (e.g., mail.yourdomain.com or news.yourdomain.com) rather than your root domain.

3. Add a Sending Node

A sending node is your email delivery infrastructure. Navigate to Setup > Sending Nodes > Add Node.

Option A: SMTP Server

For your own SMTP server:

1. Select SMTP as provider
2. Enter SMTP details:
   • Host: your-smtp-server.com
   • Port: 587 (TLS) or 465 (SSL)
   • Username: Your SMTP username
   • Password: Your SMTP password
   • Encryption: TLS (recommended)
3. Set sending limits (hourly/daily)
4. Test connection

Option B: ESP Integration

For third-party ESPs like Amazon SES:

1. Select the ESP (e.g., Amazon SES)
2. Enter API credentials:
   • Access Key ID
   • Secret Access Key
   • Region
3. Set sending limits
4. Test connection

4. Configure Bounce Handling

Set up bounce processing to maintain list hygiene.

Navigate to Setup > Bounce Addresses > Add Bounce Mailbox:

1. Email Address: The bounce address (e.g., [email protected])
2. IMAP/POP3 Settings:
   • Host: Your mail server
   • Port: 993 (IMAP SSL)
   • Username/Password
3. Processing Interval: How often to check for bounces (e.g., every 5 minutes)

5. Create Your First List

Navigate to Lists > Contact Lists > Add List:

1. List Name: Descriptive name (e.g., "Newsletter Subscribers")
2. Default From Name: Sender name for this list
3. Default From Email: Must use verified sending domain
4. Reply-To Email: Where replies go
5. List Group: Optional grouping for organization

6. Configure Cron Jobs

Verify cron jobs are running properly:

1. Navigate to Tools > Cron Status
2. Verify all cron jobs show as active
3. Check last run times are recent

If cron jobs aren't running, ensure the crontab entry is configured:

* * * * * cd /var/www/mumara && php artisan schedule:run >> /dev/null 2>&1

Security Configuration

Enable Two-Factor Authentication

For admin accounts:

1. Go to Account > Security
2. Enable Two-Factor Authentication
3. Scan QR code with authenticator app
4. Enter verification code to confirm

Configure IP Restrictions

Limit admin access by IP:

1. Go to Account > Security
2. Add allowed IP addresses
3. Enable IP restriction

API Key Management

If using the API:

1. Navigate to Settings > API Keys
2. Create new API key with appropriate permissions
3. Store the key securely (shown only once)

Test Your Setup

Send a Test Email

1. Navigate to Broadcasts > Add Broadcast
2. Create a simple test email
3. In the editor, click Send Test
4. Enter your email address
5. Verify delivery and appearance

Check Delivery

After sending:

1. Verify email arrived in inbox (not spam)
2. Check email headers for proper authentication
3. Verify DKIM signature
4. Confirm tracking links work

Recommended Settings

Application Settings

Setting	Recommended Value
Timezone	Your local timezone
Session Timeout	60 minutes
Items per Page	25-50
Track Opens	Enabled
Track Clicks	Enabled

Sending Settings

Setting	Recommended Value
Default Throttle	1000-5000/hour
Max Connections	Based on server capacity
Retry Failed	3 attempts
Bounce Processing	Every 5 minutes

Next Steps

With initial setup complete:

• User Interface Guide - Learn the dashboard