> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started with MainWP

> Learn how to install and configure MainWP Dashboard and Child plugins to manage multiple WordPress sites.

[Getting started with MainWP - Video Tutorial](https://www.youtube.com/embed/2Mj3yV_POBE)

[← Part 1: MainWP Introduction](https://docs.mainwp.com/getting-started/mainwp-introduction.md)

[Part 3: MainWP User Interface →](https://docs.mainwp.com/getting-started/mainwp-user-interface.md)

MainWP requires two components:

* **MainWP Dashboard** - Install on a dedicated WordPress site that controls all other sites
* **MainWP Child** - Install on each WordPress site you want to manage

> [!WARNING]
>
> Install MainWP Dashboard on a clean WordPress installation rather than an operating site. This eliminates plugin conflicts.

MainWP Dashboard has no site limit. Check the [System Requirements](https://docs.mainwp.com/advanced/miscellaneous/mainwp-system-requirements.md) to verify your server can handle your planned number of child sites.

## Prerequisites

Before starting, confirm you have:

* A dedicated WordPress site for the MainWP Dashboard (not an existing production site)
* PHP 8.3 or higher on the Dashboard server for MainWP Dashboard 6.4
* Administrator access to the Dashboard site
* Administrator access to each child site you want to manage
* MainWP Child plugin ready to install on child sites

## Install MainWP Dashboard

[Getting started with MainWP - Video Tutorial](https://www.youtube.com/embed/4xSncGrbuEM)

**1. Open the Plugins page**

Go to **WP Admin > Plugins** on your WordPress site dedicated to hosting MainWP Dashboard.

**2. Add new plugin**

Click **Add New**.

**3. Search for MainWP**

Enter "MainWP" in the search field and press Enter.

**4. Install the plugin**

Find **MainWP Dashboard** in the results and click **Install Now**.

**5. Activate**

Click **Activate** once installation completes.

## Manual Installation

**1. Download**

Download the [MainWP Dashboard](https://wordpress.org/plugins/mainwp) plugin.

**2. Extract**

If downloaded as a zip, extract the plugin folder.

**3. Upload via FTP**

Upload the plugin folder to `wp-content/plugins/` on your Dashboard site.

**4. Activate**

Go to **WP Admin > Plugins** and activate MainWP Dashboard.

## Quick Setup Wizard

The Quick Setup Wizard opens after a new MainWP Dashboard installation. In MainWP 6.4, it guides you through **Welcome**, **Add Site**, and **Site Summary**.

You can return to it from **MainWP menu (three lines, top right) > MainWP Tools** (`/wp-admin/admin.php?page=MainWPTools`) using **Start Quick Setup Wizard**.

### Welcome

Choose **Connect my first site** to connect one WordPress site, or **Import a CSV** to add multiple sites. Choose **Skip setup, I'll add sites later** to go to the Dashboard without connecting a site.

![Quick Setup Wizard welcome screen with options to connect a first site, import a CSV, or skip setup.](https://mintcdn.com/mainwp/xG5kW3IvhY5V-k_B/images/getting-started/setup-wizard-intro.jpg?fit=max\&auto=format\&n=xG5kW3IvhY5V-k_B\&q=85\&s=fbb25922793b39421993de995fe47fd8)

### System Check

If the Dashboard does not meet the connection requirements, the wizard shows a System Check before Add Site. [Resolve the reported issues](https://docs.mainwp.com/troubleshooting/resolve-system-requirement-issues.md) before continuing. MainWP Dashboard requires PHP 8.3 or later.

### Add Site

Install and activate [MainWP Child](#install-mainwp-child) on the site you want to connect, then complete the connection form.

**1. Enter the site details**

Enter the **Site URL** and administrator username. Use HTTPS. MainWP checks whether the site is reachable and MainWP Child is ready to connect.

**2. Authenticate the connection**

Enter the Child Site's **Administrator password**. MainWP uses it for this connection request and discards it; it is not saved or sent to MainWP.com.

If the Child Site requires a **Unique Security ID**, open **Advanced options** and use that authentication option. Enter both credentials if MainWP Child requires both.

**3. Connect the site**

Click **Connect site** when the site is ready. If the connection window has expired, deactivate and reactivate MainWP Child on the Child Site, then try again.

Use **Skip for now** to continue without connecting a site.

![Quick Setup Wizard connection form with HTTPS site URL, administrator username, connection checks, password authentication, and advanced options.](https://mintcdn.com/mainwp/xG5kW3IvhY5V-k_B/images/getting-started/setup-wizard-add-site.jpg?fit=max\&auto=format\&n=xG5kW3IvhY5V-k_B\&q=85\&s=2fc9408231eca4b92d2ab3290739b1a8)

> [!NOTE]
>
> MainWP Child requires **Require Password Authentication**, **Require Unique Security ID**, or both. Check these options in the Child Site's **Settings > MainWP Child** (`/wp-admin/options-general.php?page=mainwp_child_tab`).

For multiple sites, choose **Import a CSV** on Welcome and follow the [site import instructions](https://docs.mainwp.com/sites/management/manage-child-sites.md#import-sites-csv-import). You can also [connect multiple sites](https://docs.mainwp.com/sites/management/manage-child-sites.md#connect-multiple-sites) after setup.

### Site Summary

Review the connected site's WordPress version, available updates, uptime monitoring, and daily digest status. You can review updates before installing them, assign the site to a client, connect an AI assistant, or add another site.

On a fresh installation, the wizard enables uptime checks every 60 minutes and Site Health monitoring with an 80% threshold. Restarting the wizard on an existing Dashboard preserves its monitoring settings. See [Uptime Monitoring](https://docs.mainwp.com/sites/management/uptime-monitoring.md) and [Dashboard Settings](https://docs.mainwp.com/sites/management/mainwp-dashboard-settings.md) to adjust them.

![Quick Setup Wizard Site Summary showing a connected site's version, updates, monitoring status, and optional next steps.](https://mintcdn.com/mainwp/xG5kW3IvhY5V-k_B/images/getting-started/setup-wizard-site-summary.jpg?fit=max\&auto=format\&n=xG5kW3IvhY5V-k_B\&q=85\&s=9fe78ad1f379a936a7304a6955d3e796)

Choose whether to **Show me a guided tour of MainWP**, then click **Go to Dashboard** to finish.

## Install MainWP Child

**1. Open Plugins**

Go to **WP Admin > Plugins** on the child site you want to add.

**2. Add new plugin**

Click **Add New**.

**3. Search**

Enter "MainWP" and press Enter.

**4. Install**

Find **MainWP Child** and click **Install Now**.

**5. Activate**

Click **Activate**.

![MainWP Child plugin in WordPress plugins list](https://mintcdn.com/mainwp/hytI7oXAKZw6eFPJ/images/getting-started/child-plugin-installed.png?fit=max\&auto=format\&n=hytI7oXAKZw6eFPJ\&q=85\&s=11bede5b1b120f135aac05d819d66961)

### Manual Installation

**1. Download**

Download the [MainWP Child](https://wordpress.org/plugins/mainwp-child/) plugin.

**2. Extract**

If downloaded as a zip, extract the plugin folder.

**3. Upload via FTP**

Upload to `wp-content/plugins/` on the child site.

**4. Activate**

Go to **WP Admin > Plugins** and activate MainWP Child.

After activation, open MainWP Child settings to confirm your connection authentication options.

## MainWP Child Plugin Settings

![MainWP Child plugin settings page](https://mintcdn.com/mainwp/hytI7oXAKZw6eFPJ/images/getting-started/child-plugin-settings.png?fit=max\&auto=format\&n=hytI7oXAKZw6eFPJ\&q=85\&s=d9d18d4030dcfb0a20e99236fa2fc5c3)

| Setting | Default | Description |
| - | - | - |
| Require Password Authentication | Enabled | Requires the administrator password when connecting from Dashboard. Can be disabled only when Unique Security ID is required |
| Unique Security ID | Disabled | Requires a matching Security ID when enabled. If Password Authentication is disabled, this must remain enabled |
| Connection Timeout | 20 minutes | Auto-deactivates MainWP Child if it remains unconnected beyond this window |

MainWP Child requires at least one of **Require Password Authentication** or **Unique Security ID** to remain enabled.

For more details, see [Connection Security](https://docs.mainwp.com/advanced/miscellaneous/mainwp-connection-security.md).

## Add a Site to Your Dashboard

After installing MainWP Child, add the site to your Dashboard.

**1. Navigate to Add New**

Log into your Dashboard and go to **MainWP > Sites > Add New**.

**2. Enter site URL**

Enter your child site URL.

**3. Verify Child plugin**

Toggle **Confirm the MainWP Child plugin is active on this site** to reveal additional fields.

**4. Enter credentials**

Enter the administrator username and provide the authentication method required by MainWP Child settings:

* **Administrator password** - Required when **Require Password Authentication** is enabled
* **Unique Security ID** - Required when **Require Unique Security ID** is enabled

If both methods are enabled on the child site, provide both values.

**5. Add optional settings**

| Option | Description |
| - | - |
| Site icon | Upload custom icon or select built-in icon (favicon used if empty) |
| Tags | Organize site with existing or new tags |
| Client | Associate site with a client |
| Verify SSL certificate | Disable for self-signed or outdated certificates |
| HTTP username/password | For sites using HTTP Basic Authentication |

**6. Connect**

Click **Add Site**.

### Add-ons Settings Synchronization

When supported [MainWP Add-ons](https://mainwp.com/mainwp-add-ons/) are installed, the Add New Site form can show synchronization options:

* Install a required third-party plugin on the child site
* Apply the add-on plugin settings (or global add-on options) during site connection

> [!NOTE]
>
> If you experience connection issues:
>
> 1. Use **Test Connection** to verify Dashboard can communicate with the site
> 2. Check [Potential Issues](https://docs.mainwp.com/troubleshooting/potential-issues.md) for solutions
> 3. [Submit a support ticket](https://mainwp.com/mainwp-support/) if needed

## Test Connection

Test Connection verifies what your MainWP Dashboard can reach, which may differ from what your browser sees.

**1. Open Add New**

Go to **MainWP > Sites > Add New**.

**2. Enter URL**

Enter your child site URL.

**3. Test**

Click **Test Connection**.

![Test Connection button](https://mintcdn.com/mainwp/ESad3ziSM_hjmfCW/images/getting-started/setup-test-connection.png?fit=max\&auto=format\&n=ESad3ziSM_hjmfCW\&q=85\&s=a9a0205b92e680fe2d2761e9a72fa33f)

A successful test shows a modal with:

```
Connection successful!
URL: yoururl.com (IP: xxx.xxx.xxx.xxx) - Received HTTP-code 200 (OK)
```

For other results, see the [full list of HTTP Status Codes](https://docs.mainwp.com/troubleshooting/connection-test-results-status-codes.md).

## Protect Your Connected Sites

After connecting your first Child Site, set up its backups. MainWP Dashboard 6.4 includes [MainWP Built-In Backups](https://docs.mainwp.com/sites/backups/manage-backups.md) for creating, scheduling, and restoring backups directly through MainWP Dashboard and MainWP Child. Start with a backup and restore test on a staging site.

You can also use [API Backups](https://docs.mainwp.com/sites/backups/api-backups.md) with a supported hosting provider or an existing [backup add-on](https://docs.mainwp.com/add-ons/backups.md).

## Completion Checklist

Verify your setup is complete:

* [ ] MainWP Dashboard installed and activated on dedicated site
* [ ] Quick Setup Wizard completed (or skipped intentionally)
* [ ] MainWP Child installed on at least one child site
* [ ] Child site connected successfully (shows in **MainWP > Sites > Manage Sites**)
* [ ] Test Connection returns HTTP 200 status


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.