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

# BackWPup

> Create, schedule backups, and control BackWPup plugin settings for all Child Sites from your MainWP Dashboard. Free add-on that integrates with the BackWPup WordPress backup plugin.

## What You'll Learn

* Installing the add-on and BackWPup plugin
* Creating global and per-site backup jobs
* Scheduling and triggering backups
* Managing backup files and settings

***

> [!NOTE]
>
> **Integration Add-on** - This add-on extends MainWP to work with BackWPup. Requires BackWPup to be installed on your child sites.

![Screenshot of BackWPup add-on dashboard showing child sites with backup status](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-dashboard-overview.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=296ba6e52bb78be3c553d1956fcd7573)

With the MainWP BackWPup Add-on, you can control the [BackWPup Plugin](https://wordpress.org/plugins/backwpup/) settings for all your child sites directly from your MainWP Dashboard. This includes giving you the ability to create your child site backups and even set Backup schedules directly from your MainWP Dashboard.

## Requirements

* PHP 8.3 or higher on the Dashboard server when using MainWP Dashboard 6.4 (see [System Requirements](https://docs.mainwp.com/advanced/miscellaneous/mainwp-system-requirements.md))
* MainWP Dashboard with the BackWPup Add-on installed
* BackWPup plugin installed and activated on each child site you want to back up

> [!NOTE]
>
> On earlier MainWP Dashboard versions, the MainWP BackWPup Add-on 5.2 requires PHP 8.1 or higher. MainWP Dashboard 6.4 requires PHP 8.3 or higher. Upgrade PHP before updating, and contact your host if you need help.

## Installing the BackWPup add-on

The MainWP BackWPup add-on needs to be installed **only on your MainWP Dashboard** site. You can [install it as any other MainWP add-on](https://mainwp.com/kb/manage-extensions/#install-add-ons).

## Installing the BackWPup Plugin

For the proper use of the MainWP BackWPup Add-on, you need to install the BackWPup Plugin on your child sites. The plugin does not need to be installed on the MainWP Dashboard site.

### Install from MainWP Dashboard

**1. Login in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Plugins > Install Plugins page**

**3. In the Search field, enter BackWPup and press enter on your keyboard**

**4. After the search results appear, locate the Plugin, select the Install this Plugin option**

After the search results appear, locate the Plugin, select the **Install this Plugin** option

**5. Select your child sites in the sidebar on the right**

**6. In the Installation Options box, make sure that the Activate after installation option is selected**

In the **Installation Options** box, make sure that the **Activate after installation option** is selected

**7. Click the Complete Installation button to complete the installation**

### Install directly on Child Site

**1. Login into your child site**

**2. Go to the WP > Plugins > Add New page**

**3. In the Search field, enter BackWPup**

**4. After the search results appear, locate the BackWPup Plugin**

**5. Click the Install button**

**6. Click the Activate button**

**Important Notes:**\
After installing the BackWPup Plugin, it is required to Synchronize your sites, so your MainWP Dashboard becomes aware that the Plugin has been installed and activated.

## BackWPup Dashboard

From the **MainWP > Sites > Backup Integrations > BackWPup > BackWPup Dashboard page,** you can monitor all of your child sites where you have the BackWPup plugin installed. In the sites list, you will be notified if the plugin has an update available (the row will be highlighted in yellow) or if the plugin is deactivated (highlighted in red).

### Available Actions

![Screenshot of BackWPup ellipsis menu showing available actions](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-actions-menu.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=16a287a818e736c151c3da25bcb883cb)

From the ellipsis menu, you can access the child site's Overview and Edit pages, as well as the ability to:

* **Hide/Unhide** the BackWPup plugin on the child site
* **Open BackWPup** plugin page on the Child Site
* Use the **Backup Now** action
* Update the plugin on the child site when an update is available
* **Activate** it if it is deactivated

### **Important Notes:**

If you know that you have the BackWPup plugin installed on a child site, but the child site doesn't appear in the list, try to re-sync your sites.

## Manage BackWPup Backups

The BackWPup Add-on allows you to manage the BackWPup plugin backups directly from your MainWP Dashboard. This includes:

* Creating new backup jobs
* Edit created backup jobs
* Triggering backup jobs
* Deleting backup jobs
* Downloading existing backups
* Deleting existing backups

## Create a BackWPup Job

### Create a Global Job

![Screenshot of Add New Job page with Job Name and Job Tasks options](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-add-new-job.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=e1c71b98e73f57ecce0bef22751dfa22)

1. Go to the **MainWP > Sites > Backup Integrations > BackWPup > Add New Job** page

2. In the **Job Name** option box, Enter a **Name** for the Backup Job

3. In the **Job Tasks** option box, set tasks that you want to include in this Job: **Database** and/or **Files**

4. Select the Desired **Job Destinations**

5. Next, select the Schedule in the sidebar on the left to configure the **Scheduled execution time**\\

   ![Screenshot of backup schedule configuration options](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-schedule-config.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=9e4ea5c009cfe056c9cb4bdcb5189292)

6. Next, select the enabled Remote Storage options on the left to configure them\\

   ![Screenshot of remote storage destination configuration](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-remote-storage.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=06a0c3a14c8ce59636e3894cf29f4fb5)

7. Finally, click **Save Changes**

After you click **Save Changes**, the add-on syncs this global job to child sites that do not use **Override General Settings**.

> [!NOTE]
>
> When you run a global job with the **Backup now** action, the add-on checks every eligible child site for the job. If a site does not yet have the job mapped (for example, a site that was added after the job was created), the add-on creates the job on that child site first, then starts the backup. The mapping is only saved after the child site confirms a valid job ID, and any partial mapping is cleaned up if the child site does not respond correctly.

### Create a Backup Job on a Single Site

**1. Go to the MainWP > Sites > Manage Sites page**

**2. Locate the site where you want to create a Backup Job, and click on it's name**

**3. Click BackWPup in the sidebar on the left**

Click **BackWPup** in the sidebar on the left\\

![Screenshot highlighting BackWPup option in site sidebar](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-sidebar-option.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=78bca4cf6522d655032c23c78ce6bc61)

**4. Click the Add New Job tab, and follow the same instructions as for creating a Global Backup Job**

Click the **Add New Job** tab, and follow the same instructions as for creating a Global Backup Job

### Job Additional Settings

![Screenshot of job additional settings for database tables and file exclusions](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-job-settings.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=da69c95823836b059ef690d2b05ea02d)

Once the job is successfully created, a new set of options will appear for you, depending on your previous settings.

The add-on will allow you to manage Database tables to be backed up (in a Global Job, this cannot be modified), and additional settings for which files to back up or exclude.

## Edit a BackWPup Job

![Screenshot of Backup Jobs list with Edit action highlighted](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-edit-action.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=9e51f3ba193d047aae696e53cf630d47)

### Edit Global Job

**1. Go to the MainWP > Sites > Backup Integrations > BackWPup > Backup Jobs page**

**2. In the list of existing jobs, locate the one you want to edit**

**3. Click the Edit action**

**4. Edit job settings**

**5. Click the Save Changes button**

### Edit Job on a Single Site

**1. Go to the MainWP > Sites > Manage Sites page**

**2. Locate the site where you want to create a Backup Job, and click on it's name**

**3. Click BackWPup in the sidebar on the left**

**4. In the list of existing jobs, locate the one you want to edit**

**5. Click the Edit action**

**6. Edit job settings**

**7. Click the Save Changes button**

## Trigger BackWPup Job

![Screenshot showing Backup now action in job list](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-backup-now-action.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=a7e2e9f863fb3874e45e63749959c9d6)

> [!NOTE]
>
> MainWP Child automatically detects whether the installed BackWPup version uses the current job API or a legacy job handler. No compatibility setting is required; starting a job, stopping it, and reporting its progress use the appropriate method automatically.

### Trigger Global Schedule

**1. Go to the MainWP > Sites > Backup Integrations > BackWPup > Backup Jobs page**

**2. In the list of existing jobs, locate the one you want to edit**

**3. Click the Backup now action**

### Trigger Schedule on a Single Site

**1. Go to the MainWP > Sites > Manage Sites page**

**2. Locate the site where you want to create a Backup Job, and click on it's name**

**3. Click BackWPup in the sidebar on the left**

**4. In the list of existing jobs, locate the one you want to edit**

**5. Click the Backup now action**

## Delete BackWPup Job

![Screenshot showing Delete action in job list](https://mintcdn.com/mainwp/e07i-JbTNXjDT9ia/images/add-ons/backwpup-delete-action.png?fit=max\&auto=format\&n=e07i-JbTNXjDT9ia\&q=85\&s=e840a6d518ae56fcb0c5cddf0d1d8aff)

### Delete Global Job

**1. Go to the MainWP > Sites > Backup Integrations > BackWPup > Backup Jobs page**

**2. In the list of existing jobs, locate the one you want to edit**

**3. Click the Delete action**

### Delete Job on a Single Site

**1. Go to the MainWP > Sites > Manage Sites page**

**2. Locate the site where you want to create a Backup Job, and click on it's name**

**3. Click BackWPup in the sidebar on the left**

**4. In the list of existing jobs, locate the one you want to edit**

**5. Click the Delete action**

## Manage BackWPup Backup Files

### Download Backup Files

**1. Login in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Backup Integrations > BackWPup > Existing Backups page**

**3. In the top right of the page, select the desired child site from the dropdown, and click Apply**

In the top right of the page, select the desired child site from the dropdown, and click **Apply**

**4. Below, in the list of existing backups, locate the one you want to download**

**5. Click the Download action**

### Delete Backup Files

**1. Login in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Backup Integrations > BackWPup > Existing Backups page**

**3. In the top right of the page, select the desired child site from the dropdown, and click Apply**

In the top right of the page, select the desired child site from the dropdown, and click **Apply**

**4. Below, in the list of existing backups, locate the one you want to delete**

**5. Click the Delete action**

## Manage BackWPup Settings

The MainWP BackWPup add-on allows you to manage the BackWPup plugin settings from your dashboard. If you are using the paid version of the BackWPup plugin on your child sites, go to the **MainWP > Sites > Backup Integrations > BackWPup > Settings** page, enable the **Use premium version** toggle, and click **Save**. This reveals the **License** and **Encryption** tabs that are available only when premium settings are enabled.

### Manage BackWPup Global Settings

**1. Login in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Backup Integrations > BackWPup > Settings page**

**3. Set your preferences**

**4. Click the Save Changes button**

### Manage BackWPup Settings on a Single Site

**1. Go to the MainWP > Sites > Manage Sites page**

**2. Locate the site where you want to create a Backup Job, and click on it's name**

**3. Click BackWPup in the sidebar on the left**

**4. Click the Settings tab**

**5. Set the Overwrite General Settings option to YES and click the Save Changes button**

Set the **Overwrite General Settings** option to **YES** and click the **Save Changes** button

**6. Set your preferences**

**7. Click the Save Changes button at the bottom of the page**

***

## Database Health Check

BackWPup Integration 5.2 supplies its settings, per-site job, and global job tables and expected column definitions to MainWP Dashboard's database schema checks. With MainWP Dashboard 6.2 or later and the Add-on active, open **MainWP > Info > Server** and review the **Database** section for missing tables, missing columns, or incorrect column definitions.

See [Database Health Check](https://docs.mainwp.com/dashboard/overview/mainwp-database-health-check.md) for interpreting the results and preparing a support report. These checks report the Dashboard database structure; they do not repair tables, check Child site databases, or verify backup files.

***

## Related Resources

* [Backup Add-ons](https://docs.mainwp.com/add-ons/backups.md) - Browse all backup integrations
* [Database Health Check](https://docs.mainwp.com/dashboard/overview/mainwp-database-health-check.md) - Check the Add-on's Dashboard database structure
* [Manage Backups](https://docs.mainwp.com/sites/backups/manage-backups.md) - Understanding backup management in MainWP
* [Managing Plugins with MainWP](https://docs.mainwp.com/sites/plugins/managing-plugins-with-mainwp.md) - Installing plugins on child sites


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