Skip to main content

​
Introduction

Private Cloud customers may install additional software, known as add-ons, into their application’s build image beyond Laravel Cloud’s supported PHP extensions. Add-ons are useful when your application depends on a PHP extension or other system-level software, such as media processing libraries or monitoring agents, that is not included in the default build image.
Build add-ons must be enabled for your organization by Laravel. If you do not see the “Build configuration” section in your environment’s settings, contact support to request access.

​
Managing add-ons

Add-ons are configured per environment. The add-ons available to your organization are determined by Laravel and shown in the “Add-ons” selector.
1

Open the environment's settings

Navigate to “Environment > Settings > General” and find the “Build configuration” section.
2

Select your add-ons

Open the “Add-ons” selector and choose the add-ons your application needs. The available options are scoped to your organization.
3

Save and redeploy

Save your changes and trigger a new deployment. Like PHP version and extension changes, add-ons are baked into a freshly built image, so changes only take effect after the environment is redeployed.
The first deployment that includes a new add-on may take longer than usual while Laravel Cloud builds and caches the updated build image. Subsequent deployments will use the cached image. Once deployed, you may confirm a PHP extension add-on is loaded by running php -m from the environment’s “Commands” tab.

​
Available add-ons

The following add-ons are currently available:
  • Datadog
  • FFmpeg
  • ImageMagick
  • Kafka
  • Puppeteer
  • wkhtmltopdf
Additional add-ons are available on request. Contact us if your application requires software that is not listed above.