Sign In
Docs › Getting Started › Installation & Setup

Installation & Setup

Follow this step-by-step guide to install the Wp Admin agent plugin, connect your site, and configure automated management. Estimated time: 8–12 minutes.

Prerequisites

Before installing the Wp Admin agent, ensure your environment meets the following requirements:

🌐

WordPress Core

Version 5.8 or higher

⚙️

PHP Version

7.4 – 8.2 (Recommended: 8.1+)

🗄️

Database

MySQL 5.7+ or MariaDB 10.3+

🔑

Access Level

Administrator role + FTP/SFTP (optional)

⚠️
Note: Ensure you have a recent backup before proceeding. While our agent is non-destructive, it's always best practice to back up your site first.

Installation Steps

Download the Agent Plugin

Log in to your Wp Admin dashboard and navigate to My Sites → Add New → Download Agent. Alternatively, download directly from your WordPress account page.

# Direct download via curl
wget https://downloads.wpadmin.com/agents/wp-admin-agent-latest.zip

Upload & Activate Plugin

In your WordPress admin panel, go to Plugins → Add New → Upload Plugin. Select the downloaded ZIP file, then click "Install Now" followed by "Activate".

💡
Alternatively, use WP-CLI: wp plugin install wp-admin-agent --activate

Connect Your Site

After activation, you'll be redirected to the Wp Admin setup wizard. Paste your unique API key from your dashboard to establish a secure connection.

API_KEY="wa_live_sk_8f7g6h5j4k3l2m1n0"
# Site will validate & handshake within 10s

Initial Scan & Configuration

The agent will perform a lightweight scan of your installation, checking PHP settings, plugin conflicts, and security posture. Review the recommendations and apply the suggested configuration.

Verify Connection

Navigate to Wp Admin → Connection Status. You should see a green "Connected & Synced" indicator. Your site will now appear in your main dashboard.

Configuration Checklist

After installation, configure these core services. Toggle each feature in your dashboard or check off as you complete them.

Verification & Testing

Ensure everything is functioning correctly by running these quick checks:

  1. Visit your site's front-end and confirm normal loading
  2. Check Wp Admin → Health Report for green status across all metrics
  3. Trigger a manual backup and verify it appears in the backup log
  4. Review the connection heartbeat (should update every 60s)
✅
If all checks pass, your site is fully managed. You can now relax while we handle the technical heavy lifting.

Troubleshooting

Common issues and quick fixes during installation:

Ensure your server allows outbound HTTPS connections on port 443. If behind a proxy/firewall, whitelist api.wpadmin.com and sync.wpadmin.com.

Verify your WordPress user has Administrator privileges. Check file permissions on /wp-content/plugins/ (should be 755 for directories, 644 for files).

Regenerate your API key in your account settings and re-enter it in the plugin settings. Ensure your server time is synchronized (NTP) to avoid token expiration issues.

The agent uses minimal resources (~2-5MB RAM). If you notice slowdowns, disable heavy caching plugins temporarily or increase PHP memory limit to 256M in wp-config.php.

Need Help?

If you're stuck or encounter unexpected behavior, our engineering team is ready to assist:

  • Live Chat: Available 24/7 in your dashboard (bottom-right corner)
  • Email Support: setup-support@wpadmin.com
  • Documentation: Browse advanced guides, API references, and video tutorials
  • System Status: Check api.status.wpadmin.com for service health
Contact Support Team