diff --git a/docs/embed.md b/docs/embed.md index 8acf6a0965..fc7ed5d67b 100644 --- a/docs/embed.md +++ b/docs/embed.md @@ -103,6 +103,12 @@ EMBED=/path/to/your/app ./build-static.sh The resulting binary is the file named `frankenphp--` 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--` on other OSes) contains your self-contained app! diff --git a/docs/static.md b/docs/static.md index 803053abb1..1fbe8b6fe5 100644 --- a/docs/static.md +++ b/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: