Installation
Installation scripts for Linux/macOS, Docker images, and pre-built Windows binaries.
Previous releases (6)
| Version | Release date | Requires | Changelog |
|---|---|---|---|
| TrueAsync 0.6.5 | 2026-03-29 | PHP 8.6-dev (ZTS) | Changelog → |
| TrueAsync 0.6.4 | 2026-03-25 | PHP 8.6-dev (ZTS) | Changelog → |
| TrueAsync 0.6.3 | 2026-03-25 | PHP 8.6-dev (ZTS) | Changelog → |
| TrueAsync 0.6.2 | 2026-03-24 | PHP 8.6-dev (ZTS) | Changelog → |
| TrueAsync 0.6.1 | 2026-03-15 | PHP 8.6-dev (ZTS) | Changelog → |
| TrueAsync 0.6.0 | 2026-03-14 | PHP 8.6-dev (ZTS) | Changelog → |
Build from Source
Recommended installation method for Linux and macOS. The script downloads PHP source code, the TrueAsync extension, and builds everything automatically.
Linux (Ubuntu/Debian)
An interactive wizard will guide you through setup: choosing extensions, debug mode, installation path, and PATH configuration.
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-linux.sh | bashUbuntu, Debian, and other apt-based distributions.
Non-interactive mode (CI / automation)
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-linux.sh \
| NO_INTERACTIVE=true EXTENSIONS=all SET_DEFAULT=true bashmacOS
Apple Silicon (ARM) and Intel. Requires Homebrew.
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-macos.sh | bashNon-interactive mode (CI / automation)
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-macos.sh \
| NO_INTERACTIVE=true EXTENSIONS=all SET_DEFAULT=true bashBuild Options
--prefix DIR | Installation directory (default $HOME/.php-trueasync) |
--set-default | Add to PATH as default php |
--debug | Build with debug symbols |
--extensions PRESET | Extension set: standard, xdebug, all |
--no-interactive | Skip the interactive wizard |
Installation Management
After building, the php-trueasync utility is available:
php-trueasync rebuild | Rebuild from fresh sources |
php-trueasync version | Show installed version |
php-trueasync uninstall | Uninstall TrueAsync PHP and clean up PATH |
Docker
Pre-built images with PHP and TrueAsync. Each image includes CLI and FPM.
Available Images
trueasync/php-true-async:0.6.6-php8.6Ubuntu 24.04 — CLI + FPMtrueasync/php-true-async:0.6.6-php8.6-alpineAlpine 3.20 — CLI + FPM (lightweight)trueasync/php-true-async:0.6.6-php8.6-debugUbuntu 24.04 — CLI + FPM (debug symbols)trueasync/php-true-async:0.6.6-php8.6-frankenphpUbuntu 24.04 — FrankenPHP (Caddy + async worker)trueasync/php-true-async:latestUbuntu 24.04 — alias for latest stabletrueasync/php-true-async:latest-alpineAlpine 3.20 — alias for latest stabletrueasync/php-true-async:latest-frankenphpFrankenPHP — alias for latest stableQuick Start
docker pull trueasync/php-true-async:latest
docker run --rm trueasync/php-true-async:latest php -vRun a script:
docker run --rm -v $(pwd):/app -w /app trueasync/php-true-async:latest php script.phpUsage in Dockerfile
FROM trueasync/php-true-async:latest
COPY . /app
WORKDIR /app
CMD ["php", "server.php"]Windows
Pre-built PHP binaries with TrueAsync for Windows x64.
For general use
Debug symbols and assertions — for PHP/extension development
SHA256 hashes are available in sha256sums.txt in each release.
Quick Install (PowerShell)
irm https://raw.githubusercontent.com/true-async/releases/master/installer/install.ps1 | iex