docs: deploying on Windows

Author: mfe-a5sys

docs/compile.md

@@ -1,6 +1,6 @@
 ---
 title: Compile FrankenPHP from sources with libphp.so
-description: Build FrankenPHP from source on Linux, macOS and FreeBSD, linking PHP as a shared library via xcaddy or go build, and add custom Caddy modules and extensions.
+description: Build FrankenPHP from source on Linux, macOS, FreeBSD and Windows, linking PHP as a shared library via xcaddy or go build, and add custom Caddy modules and extensions.
 ---
 
 # Compile from sources
@@ -10,6 +10,10 @@ This is the recommended method.
 
 Alternatively, [fully and mostly static builds](static.md) can also be created.
 
+> [!NOTE]
+>
+> To compile FrankenPHP on Windows, follow [the Windows Development section of the contributing documentation](https://frankenphp.dev/docs/contributing/#windows-development).
+
 ## Install PHP
 
 FrankenPHP is compatible with PHP 8.2 and higher.

docs/embed.md

@@ -103,6 +103,12 @@ EMBED=/path/to/your/app ./build-static.sh
 
 The resulting binary is the file named `frankenphp-<os>-<arch>` in the `dist/` directory.
 
+> [!NOTE]
+>
+> Standalone binaries can currently be created for Linux and macOS only,
+> as [static builds are not available for Windows](static.md).
+> To create a Linux binary from Windows, use the Docker-based builder or [WSL](https://learn.microsoft.com/windows/wsl/).
+
 ## Using the binary
 
 This is it! The `my-app` file (or `dist/frankenphp-<os>-<arch>` on other OSes) contains your self-contained app!

docs/production.md

@@ -1,6 +1,6 @@
 ---
-title: Deploying FrankenPHP in production with Docker Compose
-description: Deploy a PHP application to production with FrankenPHP and Docker Compose on a single Linux server, including TLS, reverse proxy, and multi-node setups.
+title: Deploying FrankenPHP in production
+description: Deploy a PHP application to production with FrankenPHP and Docker Compose on a single Linux server, including TLS, reverse proxy, and multi-node setups, or natively on Windows.
 ---
 
 # Deploying in production
@@ -171,3 +171,48 @@ which can cause issues like incorrect HTTPS detection or wrong client IP address
 If you want to deploy your app on a cluster of machines, you can use [Docker Swarm](https://docs.docker.com/engine/swarm/stack-deploy/),
 which is compatible with the provided Compose files.
 To deploy on Kubernetes, take a look at [the Helm chart provided with API Platform](https://api-platform.com/docs/deployment/kubernetes/), which uses FrankenPHP.
+
+## Deploying on Windows
+
+FrankenPHP runs natively on Windows, with full support for [the worker mode](worker.md) and [hot reloading](hot-reload.md).
+
+To install it, run this in PowerShell:
+
+```powershell
+irm https://frankenphp.dev/install.ps1 | iex
+```
+
+Alternatively, [download the Windows archive from the releases page](https://github.com/php/frankenphp/releases).
+It contains the FrankenPHP executable as well as the official PHP binary for Windows.
+
+To run FrankenPHP in the background and start it automatically at boot, register it as a Windows service.
+As [recommended by the Caddy documentation](https://caddyserver.com/docs/running#windows-service), use [WinSW](https://github.com/winsw/winsw):
+
+1. Download [the latest version of WinSW](https://github.com/winsw/winsw/releases) as `frankenphp-service.exe` in the directory containing `frankenphp.exe`
+2. In the same directory, create a `frankenphp-service.xml` file:
+
+   ```xml
+   <service>
+     <id>frankenphp</id>
+     <name>FrankenPHP</name>
+     <description>The modern PHP app server (https://frankenphp.dev)</description>
+     <executable>%BASE%\frankenphp.exe</executable>
+     <arguments>run --config %BASE%\Caddyfile</arguments>
+     <log mode="roll-by-time">
+       <pattern>yyyy-MM-dd</pattern>
+     </log>
+   </service>
+   ```
+
+3. Install and start the service:
+
+   ```powershell
+   .\frankenphp-service.exe install
+   .\frankenphp-service.exe start
+   ```
+
+Windows services cannot be reloaded. To apply configuration changes gracefully, without restarting the service, run:
+
+```powershell
+.\frankenphp.exe reload --config Caddyfile
+```

docs/static.md

@@ -19,6 +19,12 @@ When possible, we recommend using glibc-based, mostly static builds.
 
 FrankenPHP also supports [embedding the PHP app in the static binary](embed.md).
 
+> [!NOTE]
+>
+> Static builds are not available for Windows: on this platform, FrankenPHP links against the official PHP binaries,
+> which are included in [the provided archives](https://github.com/php/frankenphp/releases).
+> To create a static Linux binary from Windows, use the Docker-based builders or [WSL](https://learn.microsoft.com/windows/wsl/).
+
 ## Linux
 
 We provide Docker images to build static Linux binaries: