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)0445↓93.3%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 yesterday

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

29

—

LowBetter than 57% of packages

Maintenance43

Moderate activity, may be stable

Popularity13

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

471d 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/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[laravel/sail

Docker files for running a basic Laravel application.

1.9k205.7M1.3k](/packages/laravel-sail)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.5k21.5M587](/packages/laravel-boost)[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[livewire/flux

The official UI component library for Livewire.

9527.8M128](/packages/livewire-flux)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)

PHPackages © 2026

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