diff --git a/README.md b/README.md
index 2b707ff0b..6765d288f 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,7 @@ For the full documentation see https://box-project.github.io/box.
1. [Homebrew](doc/installation.md#homebrew)
1. [GitHub](doc/installation.md#github)
1. [Docker](doc/installation.md#docker)
+ 1. [shivammathur/setup-php (GitHub Actions)](doc/installation.md#shivammathursetup-php-github-actions)
1. [Usage](#usage)
1. [Configuration][the configuration documentation]
1. [Base path (`base-path`)](doc/configuration.md#base-path-base-path)
diff --git a/doc/installation.md b/doc/installation.md
index 82ad70046..3f097d934 100644
--- a/doc/installation.md
+++ b/doc/installation.md
@@ -5,6 +5,7 @@
1. [Homebrew](#homebrew)
1. [GitHub](#github)
1. [Docker](#docker)
+1. [shivammathur/setup-php (GitHub Actions)](#shivammathursetup-php-github-actions)
## Phive
@@ -90,6 +91,18 @@ The official docker image for the project is [`boxproject/box`][docker-image]:
docker pull boxproject/box
```
+## `shivammathur/setup-php` (GitHub Actions)
+
+Box is supported as a [shivammathur/setup-php tool]:
+
+```yaml
+- name: Setup PHP with tools
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: '8.3'
+ tools: box
+```
+