Email Setup

Configure SMTP to send invoices, notifications, and password reset emails.

Why Configure Email?

Qserve uses email to send invoices, package activation confirmations, password reset links, and subscription expiry reminders to subscribers. You need to configure an outgoing SMTP server for these to work.

Configuring SMTP

Go to Admin → Email Settings.
Fill in your SMTP details (see table below).
Click Test Connection — Qserve sends a test email to your admin address.
Save when confirmed.

SMTP Configuration Fields

Field	Description
SMTP Host	Your mail server hostname, e.g. `smtp.gmail.com`
SMTP Port	587 (TLS/STARTTLS) or 465 (SSL) — use 587 for Gmail
Username	Your email address or SMTP login
Password	SMTP password or App Password (for Gmail)
From Name	Sender display name, e.g. "MyISP Billing"
From Email	The address emails are sent from, e.g. `billing@myisp.co.ke`
Encryption	TLS (recommended) or SSL

Gmail / Google Workspace Setup

If using Gmail or Google Workspace:

Enable 2-Step Verification on your Google account.
Go to Google Account → Security → App Passwords.
Create an App Password for "Mail" → "Other device" and name it "Qserve".
Use smtp.gmail.com, port 587, TLS enabled, and the App Password as the SMTP password.

Do not use your Google account password directly. Always use an App Password — Google blocks regular password authentication for SMTP in most cases.

Custom Domain Email (Recommended)

For a professional appearance, use an email address on your own domain (e.g., billing@myfastisp.co.ke). This can be set up with Google Workspace, Zoho Mail, or any other business email provider. Configure their SMTP settings in Qserve the same way as above.

Email Templates

Qserve's email templates use your ISP name and branding from Settings. You can customise the content of notification emails in Settings → Notification Templates → Email. Available variables are the same as SMS templates ({name}, {plan}, {expiry}, etc.)

User Roles & Access