---
title: "Install | DRAWBRIDGE docs"
description: "How to clone Drawbridge and get it running with Docker, the only thing you need, with separate commands for Windows and for Linux and macOS."
url: https://drawbridge.apps.wayne.edu/docs/install.html
llms: https://drawbridge.apps.wayne.edu/llms.txt
generator: Squire agent-ready
---

# Install [#](https://drawbridge.apps.wayne.edu/docs/install.html#install)

This page gets you from a clean machine to a built gateway image with Docker, or to the published image from the registry.

## Requirements [#](https://drawbridge.apps.wayne.edu/docs/install.html#requirements)

You need Docker and nothing else. The PHP component needs PHP 8.3 or newer and Composer, and these steps run both inside the `composer:2.11.1` container. `composer.json` requires PHP `^8.3` and the `ext-openssl` extension; the runtime libraries are `lcobucci/jwt`, `psr/clock`, `symfony/console`, `symfony/yaml` and `promphp/prometheus_client_php`.

## Install [#](https://drawbridge.apps.wayne.edu/docs/install.html#install-1)

The commands below clone the repository, install the dependencies, copy the example config and environment file, validate the config and build the gateway image. With PHP installed locally the same commands are `composer install` and `php bin/drawbridge ...`.

PowerShell

```powershell
git clone https://git.wayne.edu/enterprise-apps/drawbridge.git; cd drawbridge
docker run --rm -v "${PWD}:/app" -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 composer install --no-interaction
Copy-Item .env.example .env
Copy-Item config\drawbridge.example.yaml config\drawbridge.yaml
docker run --rm -v "${PWD}:/app" -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 php bin/drawbridge config:validate --config=config/drawbridge.yaml
docker build -f docker/gateway/Dockerfile -t drawbridge-gateway .
```

sh

```sh
git clone https://git.wayne.edu/enterprise-apps/drawbridge.git && cd drawbridge
docker run --rm -v "$PWD:/app" -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 composer install --no-interaction
cp .env.example .env
cp config/drawbridge.example.yaml config/drawbridge.yaml
docker run --rm -v "$PWD:/app" -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 php bin/drawbridge config:validate --config=config/drawbridge.yaml
docker build -f docker/gateway/Dockerfile -t drawbridge-gateway .
```

## Getting the image [#](https://drawbridge.apps.wayne.edu/docs/install.html#getting-the-image)

Instead of building, pull the published image. The pipeline builds the gateway image on every merge request and on the default branch, and publishes it to the stack's image registry (the group's `images` project) when a tag is pushed. The image is at `<registry>/enterprise-apps/images/drawbridge-gateway:<tag>` (for example `<registry>/enterprise-apps/images/drawbridge-gateway:0.6.2`). `<registry>` is the stack's container registry; Enterprise Applications has its address.

Warning

There is no `latest` tag: pin a release.

```sh
docker pull <registry>/enterprise-apps/images/drawbridge-gateway:0.6.2
```

The image carries OCI labels (`org.opencontainers.image.source`, `.revision`, `.version`, `.licenses`) set from the pipeline's commit; a local `docker build` leaves them empty.

Note

The image also refuses to build if Debian serves apache2 or mod_auth_openidc below the versions the rig tested: the Dockerfile checks the installed versions with `dpkg --compare-versions` right after the install and stops the build with a clear message when one is lower. The floor is apache2 2.4.69-1~deb13u1 and mod_auth_openidc 2.4.17-1+deb13u1 (Debian's fix for CVE-2026-54789), against debian:trixie-slim.

## Verify [#](https://drawbridge.apps.wayne.edu/docs/install.html#verify)

The publish job prints the digest it pushed. Verify the image you pulled against it:

```sh
docker inspect --format='{{index .RepoDigests 0}}' <registry>/enterprise-apps/images/drawbridge-gateway:0.6.2
```

The command prints the digest of the image you pulled; compare it with the digest the publish job printed.

## Next steps [#](https://drawbridge.apps.wayne.edu/docs/install.html#next-steps)

- [Quick start](https://drawbridge.apps.wayne.edu/docs/guides/quick-start.html): validate, build and run the rig against a mock provider.
- [Try it without Entra](https://drawbridge.apps.wayne.edu/docs/guides/try-without-entra.html): the local trial in depth.
- [Register Drawbridge in Entra ID](https://drawbridge.apps.wayne.edu/docs/guides/register-in-entra.html): the app registration for the first real sign-in.
- [Getting the image](https://drawbridge.apps.wayne.edu/docs/deploying/getting-the-image.html): the full image route.

## Related [#](https://drawbridge.apps.wayne.edu/docs/install.html#related)

- [Overview](https://drawbridge.apps.wayne.edu/docs/index.html)
- [Quick start](https://drawbridge.apps.wayne.edu/docs/guides/quick-start.html)
- [Getting the image](https://drawbridge.apps.wayne.edu/docs/deploying/getting-the-image.html)
- [Configuration](https://drawbridge.apps.wayne.edu/docs/reference/configuration.html)
- [Changelog](https://drawbridge.apps.wayne.edu/docs/changelog.html)
