---
title: "WordPress"
description: "How to run WordPress with FrankenPHP, including a minimal install, a production Caddyfile, and enabling hot reload via Mercure."
sidebar:
  label: "WordPress integration"
  order: 2
seo:
  title: "Running WordPress with FrankenPHP (HTTPS, HTTP/3, hot reload)"
---
Run [WordPress](https://wordpress.org/) with FrankenPHP to enjoy a modern, high-performance stack with automatic HTTPS, HTTP/3, and Zstandard compression.

## Installing WordPress with FrankenPHP

1. [Download WordPress](https://wordpress.org/download/)
2. Extract the ZIP archive and open a terminal in the extracted directory
3. Run:

   ```console
   frankenphp php-server
   ```

4. Go to `http://localhost/wp-admin/` and follow the installation instructions
5. Enjoy!

For a production-ready setup, prefer using `frankenphp run` with a `Caddyfile` like this one:

```caddyfile
example.com

php_server
encode zstd br gzip
log
```

## Hot reload for WordPress

To use the [hot reload](/zh/docs/hot-reload) feature with WordPress, enable [Mercure](/zh/docs/mercure) and add the `hot_reload` sub-directive to the `php_server` directive in your `Caddyfile`:

```caddyfile
localhost

mercure {
    anonymous
}

php_server {
    hot_reload
}
```

Then, add the code needed to load the JavaScript libraries in the `functions.php` file of your WordPress theme:

```php
// wp-content/themes/<your-theme>/functions.php
function hot_reload() {
    ?>
    <?php if (isset($_SERVER['FRANKENPHP_HOT_RELOAD'])): ?>
        <meta name="frankenphp-hot-reload:url" content="<?=$_SERVER['FRANKENPHP_HOT_RELOAD']?>">
        <script src="https://cdn.jsdelivr.net/npm/idiomorph/dist/idiomorph.min.js"></script>
        <script src="https://cdn.jsdelivr.net/npm/frankenphp-hot-reload/+esm" type="module"></script>
    <?php endif ?>
    <?php
}
add_action('wp_head', 'hot_reload');
```

Finally, run `frankenphp run` from the WordPress root directory.