---
title: Install AWP Support Desk and Run the Setup Wizard
description: "Install AWP Support Desk on WordPress 6.6+ with PHP 8.1, run the three-step setup wizard, create the portal page and open your first support ticket."
url: "https://awp-software.com/docs/installation/"
updated: "2026-11-14"
category: AWP Support Desk
---

# Install AWP Support Desk and Run the Setup Wizard

AWP Support Desk is a self-hosted support ticket system that runs entirely on your WordPress site. This guide takes you from install to first answered ticket: activating the plugin, running the three-step setup wizard, publishing the customer portal and opening the first conversation. It takes about ten minutes.

## What you need

- WordPress 6.6 or newer and PHP 8.1 or newer.
- An administrator account on the site.
- Nothing else. The plugin makes no external calls, needs no third-party account and works with block themes and classic themes.

## Install and activate

1. In your WordPress admin, open **Plugins → Add New** and upload the plugin, or copy the `awp-support-desk` folder into `/wp-content/plugins/`.
2. Open the **Plugins** screen and activate **AWP Support Desk**.
3. Activation creates the ticket tables in your own database, adds the four support roles and prepares the setup wizard. Your data stays on your server.
4. Open **Support Desk** in the admin menu. The agent inbox opens, and **Support Desk → Setup** holds the wizard.

## Run the setup wizard

The wizard has three steps. You can pause at any point and come back later from **Support Desk → Setup**; your progress is saved and the inbox never blocks on it. Only administrators can run the wizard.

1. Open **Support Desk → Setup**.
2. **Customer portal.** Select the published page that will hold the portal, or use **Create a portal page for me**, which creates and publishes a page with the shortcode already inside.
3. **People and notifications.** Review the support roles on the site and set the **Notification mailbox**, the address that receives new tickets and customer replies.
4. **First test ticket.** Open a ticket to check the inbox and the notifications, then finish the wizard.

## Create the portal page manually

If you prefer to set up the portal page yourself:

1. Create a normal WordPress page, for example *Support*.
2. Add the `Log in to open a support ticket and review your conversation history.Log in` shortcode or the **AWP Support Portal** block to the page content.
3. Publish the page.
4. Go to **Support Desk → Settings**, select the page under **Customer portal page** and save. Links in notification emails point to this page.

If your theme is a block theme, the portal inherits its palette, fonts, button styles and corner radius automatically.

## Open your first real ticket

1. In **Users → Add New**, create an account for a customer and assign the **Support customer** role.
2. Ask the customer to open the portal page and log in with their WordPress account.
3. The customer submits the new-ticket form. The staff mailbox receives the notification.
4. Open **Support Desk**, open the ticket and reply from the ticket detail screen.
5. The customer receives the reply by email and in the portal thread.

## Automate from the command line

For migrations and integrations, three WP-CLI commands cover the common operations. Each command enforces the same permissions as its screen, so run them with `--user=<admin>`:

```
wp awp ticket list --status=open --assignee=3 --format=json
wp awp ticket create --customer=12 --subject="Printer offline" --body="It stopped printing on Monday." --porcelain
wp awp ticket assign 7 --agent=3
```

`list` also outputs `table`, `csv`, `ids` and `count`; `create` accepts `--priority`; `assign` accepts `--unassign` to clear the assignee. Developers who prefer HTTP can use the REST API under `/wp-json/awp/v1/`, authenticating with WordPress application passwords.

## What deleting the plugin keeps

Deleting the plugin keeps your data by default: tickets, messages, attachments, settings and the support roles remain in the database. To remove everything when the plugin is deleted, set the `awp_delete_data_on_uninstall` option to `true` first. On a multisite network this cleanup runs for every site, and users who only held a support role move to the Subscriber role so that no account is left without one.

One honest limit to plan around: the Free plugin does not convert inbound email into tickets, has no knowledge base and its reports are basic. Those belong to the paid Pro add-on.

## Next steps

Your desk is live. Point agents to the [agent inbox guide](/docs/agent-inbox/) and customers to the [customer portal guide](/docs/customer-portal/). Before launch, read the [email notifications guide](/docs/email-notifications/) so the right mailbox receives every ticket. The [product page](/products/support-desk/) summarizes the full feature set, and the plugin is available on the [WordPress.org listing](https://wordpress.org/plugins/awp-support-desk/).
