> ## Documentation Index
> Fetch the complete documentation index at: https://docker-php.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the client and its matching generated API package.

## Requirements

* PHP 8.1 or later, with the `mbstring` extension.
* [Composer](https://getcomposer.org/).
* Access to a Docker daemon that accepts API v1.45 requests.

## Stable installation

<Note>
  Docker PHP 3.0.0 and API package 7.1.45.0 have not been released yet. Use this
  command once both packages are available.
</Note>

```bash theme={null}
composer require "docker-php/docker-php:^3.0"
```

Composer installs the matching `docker-php/docker-php-api` dependency. If your
application requires the API package directly, keep its constraint within one
[API line](/api-versions).

## Test the development version

For a disposable test application before release, explicitly allow both
development packages:

```bash theme={null}
composer require "docker-php/docker-php:3.0.x-dev" "docker-php/docker-php-api:7.1.45.x-dev" --with-all-dependencies
```

Do not use these moving development versions for an unattended production
upgrade. Commit your application's `composer.lock` after testing.

If you already use Docker PHP or Beluga, follow the [migration guide](/migration)
instead of installing both package families together.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.