Knowledge base / Run

WordPress local sites

One-click create plus detection of existing WP folders.

Applies to · Mac · ~3 min

Rig detects existing WordPress folders and can create a new local site in one click from New Project → WordPress.

One-click create

Needs Homebrew PHP 8.1+ and Docker Desktop. Rig downloads WordPress core, provisions an isolated MySQL container, writes wp-config.php and a per-project php.ini, runs wp core install, starts php -S with a pretty-permalinks router, and proxies trusted HTTPS at https://{slug}.localhost. Admin credentials land in the project's local env profile (WP_ADMIN_USER / WP_ADMIN_PASSWORD) — use Copy admin login in the project inspector.

Detection

Existing sites with wp-config.php (or sample + wp-includes) show up as WordPress when you add a folder. Rig-managed installs keep a .rig/wordpress.json serve command so Start/Stop works without Valet.

What Local still does better

Per-site PHP version UI, blueprints, clone/export, and WP Engine hosting funnel tooling are still Local strengths — not Rig v1.

See also

Was this helpful?Updated Aug 2026 · Open Support

Works with

Available for any MCP client — including