Installation

Installation scripts for Linux/macOS, Docker images, and pre-built Windows binaries.

Current Release

TrueAsync 0.6.4

Release date: 2026-03-25 · Requires PHP 8.6-dev (ZTS)

All builds are Thread Safe (ZTS). Changelog →

Previous releases (4)
Version Release date Requires 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 | bash

Ubuntu, 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 bash

macOS

Apple Silicon (ARM) and Intel. Requires Homebrew.

curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-macos.sh | bash

Non-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 bash

Build 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.4-php8.6 Ubuntu 24.04 — CLI + FPM
trueasync/php-true-async:0.6.4-php8.6-alpine Alpine 3.20 — CLI + FPM (lightweight)
trueasync/php-true-async:0.6.4-php8.6-debug Ubuntu 24.04 — CLI + FPM (debug symbols)
trueasync/php-true-async:latest Ubuntu 24.04 — alias for latest stable
trueasync/php-true-async:latest-alpine Alpine 3.20 — alias for latest stable

Quick Start

docker pull trueasync/php-true-async:latest
docker run --rm trueasync/php-true-async:latest php -v

Run a script:

docker run --rm -v $(pwd):/app -w /app trueasync/php-true-async:latest php script.php

Usage 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.

php-trueasync-0.6.4-php8.6-windows-x64.zip ~25 MB
For general use
php-trueasync-0.6.4-php8.6-windows-x64-debug.zip ~30 MB
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
Previous releases (4)
Version Release date Release Debug
0.6.3 2026-03-25 ~37.6 MB ~35.1 MB
0.6.2 2026-03-24 ~37.6 MB ~35.1 MB
0.6.1 2026-03-15 ~37.6 MB ~35.1 MB
0.6.0 2026-03-14 ~37.6 MB ~35.1 MB