PHPackages                             braceyourself/compose - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. braceyourself/compose

ActiveLibrary[DevOps & Deployment](/categories/devops)

braceyourself/compose
=====================

Initialize your application using docker and docker compose

0.7.1(1y ago)0291↓66.7%MITPHP

Since Jul 1Pushed 1y ago1 watchersCompare

[ Source](https://github.com/braceyourself/compose)[ Packagist](https://packagist.org/packages/braceyourself/compose)[ RSS](/packages/braceyourself-compose/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (44)Used By (0)

Compose for Laravel
===================

[](#compose-for-laravel)

[![compose-for-laravel](https://camo.githubusercontent.com/fe1d720c4447b2af30c10a06fa8d0bc298fa48ad39e958d7d46368f038d33ca5/68747470733a2f2f657468616e62726163652e636f6d2f73746f726167652f30314a343457324b593259484e50543846565637474141484e562e706e67)](https://camo.githubusercontent.com/fe1d720c4447b2af30c10a06fa8d0bc298fa48ad39e958d7d46368f038d33ca5/68747470733a2f2f657468616e62726163652e636f6d2f73746f726167652f30314a343457324b593259484e50543846565637474141484e562e706e67)

### This package is in development and not yet ready for production use.

[](#this-package-is-in-development-and-not-yet-ready-for-production-use)

Introduction
------------

[](#introduction)

Compose for Laravel is a package that simplifies running and deploying Laravel applications using Docker Compose. It supports macOS, Linux, and Windows (WSL2). This package leverages Docker Compose for container orchestration and Traefik for routing HTTP requests.

Installation
------------

[](#installation)

To install Compose for Laravel, include it in your Laravel application's `composer.json` file:

```
composer require --dev braceyourself/compose
```

Upon installation, the `compose` script will be available in `vendor/bin`. Run the install command to set up node\_modules and composer dependencies.

```
./vendor/bin/compose install
```

Usage
-----

[](#usage)

### Available Commands

[](#available-commands)

```
compose COMMAND [options] [arguments]
```

- **compose install**: Uses docker containers to install composer and npm dependencies
- **compose build**: Build the Docker containers
- **compose start**: Start the application (docker-compose up -d)
- **compose deploy**: Deploy the application to a remote server

#### All other commands are passed to docker compose or artisan

[](#all-other-commands-are-passed-to-docker-compose-or-artisan)

You can always use docker compose directly after running compose the first time.
--------------------------------------------------------------------------------

[](#you-can-always-use-docker-compose-directly-after-running-compose-the-first-time)

After running compose for the first time, the docker-compose file will be published to your project root.

Environment Variables
---------------------

[](#environment-variables)

Ensure you have a `.env` file in your project root. The script will source this file to set up the necessary environment variables.

When running the `deploy` command, the remote `.env` file will be created based on your `.env.example` file

Troubleshooting
---------------

[](#troubleshooting)

If you encounter issues, ensure your system meets the requirements and that Docker and Docker Compose are properly installed and configured.

Please report any issues.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance46

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

43

Last Release

425d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/800a552743067dabc5dd8cb69019e0526e402529857038951d5e23174698bf48?d=identicon)[braceyourself](/maintainers/braceyourself)

---

Top Contributors

[![braceyourself](https://avatars.githubusercontent.com/u/13386086?v=4)](https://github.com/braceyourself "braceyourself (313 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/braceyourself-compose/health.svg)

```
[![Health](https://phpackages.com/badges/braceyourself-compose/health.svg)](https://phpackages.com/packages/braceyourself-compose)
```

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k186.9M1.0k](/packages/laravel-sail)[orchestra/canvas

Code Generators for Laravel Applications and Packages

20917.2M158](/packages/orchestra-canvas)[sammyjo20/lasso

Lasso - Asset wrangling for Laravel made simple.

355347.9k](/packages/sammyjo20-lasso)[laravel/roster

Detect packages & approaches in use within a Laravel project

15510.4M7](/packages/laravel-roster)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[thebytelab/vapor-multi-region-deploy

An artisan command to assist deploying your Laravel Vapor app to multiple AWS regions

162.2k](/packages/thebytelab-vapor-multi-region-deploy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)