Mirror Domains & Staging

Configure domain aliases (dev, staging, QA) that share the same hosting folder as your production site. Each mirror can independently bypass offline mode and control search engine indexing.

Setup

Go to Extensions > Plugins > System - MokoSuiteClient DevTools
Click the Mirror Domains & Staging Environments tab
Add domain aliases using the repeatable table

Fields

Field	Description	Example
Domain	The CNAME/A record alias pointing to the same hosting folder	`dev.clientsite.com`
Offline Mode	Bypass (stay online) or Respect (go offline with main site)	Bypass
Robots	Search engine directive for this alias	`noindex, nofollow`
Label	Descriptive name (optional)	Development, Staging, QA

How It Works

When a request comes in, the core plugin checks HTTP_HOST against all configured aliases
If a match is found and Bypass is enabled, offline mode is disabled for that request
The configured robots directive is injected as a meta tag
A canonical URL pointing to the primary domain is added

Default Behavior

When no aliases are configured, the system automatically includes dev.{primary_domain} as a default alias with:

Offline bypass: enabled
Robots: noindex, nofollow
Label: Development

Example Configuration

Domain	Offline Mode	Robots	Label
dev.clientsite.com	Bypass	noindex, nofollow	Development
staging.clientsite.com	Bypass	noindex, nofollow	Staging
qa.clientsite.com	Respect	noindex	QA

HQ Integration

The first configured alias (or the auto-detected dev domain) is sent to MokoSuiteHQ in the heartbeat payload as dev_domain. It appears as a blue badge on the HQ dashboard site cards.

Prerequisites

The alias domain must point to the same hosting folder (CNAME or A record)
The primary_domain must be set in the core plugin config (auto-detected on first save)
SSL certificate must cover the alias domain (wildcard or SAN)

Related: Configuration • Health Monitoring

Pages