ARN Smart Support
Language: English

Connect a WordPress site with the Agent plugin

Updated 9 Nov 2026 4 min read

Thanks for your feedback.

Browse ARN Connect articles

Every WordPress site you manage with ARN Connect needs the Agent plugin, ARN Connect Agent in WordPress. You connect ("pair") the site once with a connection key. No WordPress password is asked for or stored.

ARN Connect illustration of pairing a WordPress site with a one-time key valid for 30 minutes

Before you start

  • Check the site requirements.
  • Get the Agent ZIP from ARN Connect: click Download Agent in the + Add site window, or open Settings → Integrations and use the ARN Connect Agent card. Keep it as a ZIP file; do not extract it.
  • Sign in to the site's wp-admin as an administrator (on Multisite, as a network administrator).

1. Install the Agent plugin

  1. In wp-admin, go to Plugins → Add Plugin → Upload Plugin. Depending on your WordPress version, the button may say Add New Plugin or Add New.
  2. Click Choose File, select the Agent ZIP and click Install Now.
  3. Click Activate Plugin.

On Multisite, upload the ZIP under Network Admin → Plugins and network-activate it.

The Agent adds one screen: Settings → ARN Connect (on Multisite Network Admin → Settings → ARN Connect). If the screen shows a warning about the sodium functions or about AUTH_KEY and SECURE_AUTH_KEY, fix that first; the site cannot be connected until then.

2. Create a connection key on the site

  1. Open Settings → ARN Connect.
  2. In Name, enter a name for this connection, for example your company name.
  3. In Level, keep Owner for the first connection of the site. The Owner can do everything, including Agent updates and managing other connections.
  4. Click Create connection key.
  5. Click Copy. The key is shown only once and is valid for 30 minutes.

3. Add the site in ARN Connect

  1. In ARN Connect, click + Add site at the top of the window.
  2. Paste the key into Connection key.
  3. Optionally enter a Display name.
  4. Tick This is a local or development site only for a test site that uses http:// or a private network address. Never tick it for a public site.
  5. Click Connect site.

ARN Connect connects only to the address inside the key and checks that the site reports the same address. The site page opens, and the first checks and the inventory follow within a few minutes. Until the Agent has answered, the site is shown in grey.

About connection keys

  • A key works once and expires after 30 minutes or after 20 failed attempts.
  • At most three keys can wait on a site at the same time, and at most five ARN Connect installations can be connected to one site.
  • A waiting key cannot be shown again. If you lost it, click Revoke next to it and create a new one.
  • Connecting the same ARN Connect installation again replaces its previous connection.

To connect a second installation, for example a reseller's, with a lower level, see Several connections and levels.

If the site cannot be connected

  • The key expired or was used. Create a new key and paste it within 30 minutes.
  • The site address uses http://. Public sites need https:// with a valid certificate.
  • A firewall blocks the requests. Allow the User-Agent ARN-Connect for /wp-json/arn-ops/v1/ (or /?rest_route=/arn-ops/v1/). The User-Agent also carries (ARN-Operations), so rules written for the earlier name keep working.
  • The security keys of the site changed. If AUTH_KEY or SECURE_AUTH_KEY in wp-config.php changed, the Agent cannot read its keys; connect the site again with a new key.

Disconnect a site

  • In ARN Connect: open the site and click Disconnect. ARN Connect asks the Agent to forget this installation and stops monitoring the site. The history stays in ARN Connect and the plugin stays installed. If the Agent could not be reached, click Disconnect on the site's Settings → ARN Connect screen as well.
  • On the site: click Disconnect next to one connection, or Disconnect all, on Settings → ARN Connect.
  • Uninstalling the plugin deletes all Agent data, backup files waiting on the site and rollback copies.

Deactivating the plugin is not a disconnection: it removes backup files, rollback copies and its must-use plugins, but keeps the connections, so a reactivated Agent is reachable again.

To remove a site and its history from ARN Connect completely, use Delete. See Manage your sites.

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close