PHPackages                             fireworkweb/fwd - 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. [Framework](/categories/framework)
4. /
5. fireworkweb/fwd

AbandonedArchivedApplication[Framework](/categories/framework)

fireworkweb/fwd
===============

Tool for simple docker based environments for Laravel applications.

v1.0.3(5y ago)21116[2 issues](https://github.com/fireworkweb/fwd/issues)MITPHPPHP ^7.2.5

Since Mar 19Pushed 5y ago2 watchersCompare

[ Source](https://github.com/fireworkweb/fwd)[ Packagist](https://packagist.org/packages/fireworkweb/fwd)[ Docs](https://github.com/fireworkweb/fwd)[ RSS](/packages/fireworkweb-fwd/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (9)Versions (51)Used By (0)

### fireworkweb/fwd

[](#fireworkwebfwd)

ATTENTION - `fwd` is dead, long live [`kool`](https://github.com/kool-dev/kool)
===============================================================================

[](#attention---fwd-is-dead-long-live-kool)

The FWD project has been discontinued in favour of our new solution - [`kool`](https://github.com/kool-dev/kool). FWD has helped a lot for development teams to leverage Docker containers for local development. `kool` now continues the same mission with more power and flexibility, plus it aims at making [cloud native software development](https://kool.dev) easy for individuals and teams, as well as has a strong maintainer team behind commited to make it grow in adoption and features.

The new [kool](https://github.com/kool-dev/kool) tool is available and should be used for any new projects. Also please take a look at the  and look for now to migrate from `fwd` to `kool` (article soon to be published).

Below you will find original `fwd` README for the sake of historic value.

---

[![GitHub Workflow Status](https://camo.githubusercontent.com/6e0f0c9f0a9ebfd662281e1de86949b1c673f6f24d1bfe61e189a6881286d4f4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f66697265776f726b7765622f6677642f6c696e742d746573743f6c6162656c3d6275696c64)](https://github.com/fireworkweb/fwd/actions)[![codecov](https://camo.githubusercontent.com/6c9af17ff2aa23ab0f85adfc805628db7ae0c9cebcfbcc5b1386f0aaa06fc07a/68747470733a2f2f636f6465636f762e696f2f67682f66697265776f726b7765622f6677642f6272616e63682f312e302d72632f67726170682f62616467652e737667)](https://codecov.io/gh/fireworkweb/fwd)

Installation &amp; Requirements
-------------------------------

[](#installation--requirements)

You need to have PHP 7.2+ installed in order to run `fwd`.

```
curl -L "https://github.com/fireworkweb/fwd/raw/master/builds/fwd" -o /usr/local/bin/fwd
chmod +x /usr/local/bin/fwd
```

- Don't have and don't want to have PHP installed locally? Checkout and follow [\#21](https://github.com/fireworkweb/fwd/issues/21) for 100% Docker usage, thus not requiring PHP.

Getting started
---------------

[](#getting-started)

#### Use in a new project

[](#use-in-a-new-project)

`fwd` is great for running Docker Compose based projects. If you wanna use it in your project simply go to the root folder and use:

```
fwd install

```

This will create the `.fwd` (environment variables) and `docker-compose.yml` (services definitions) files in your project (you probably want to have them versioned).

You should review the variables and services in both files to best suit them to your project needs. The out-of-the-box configuration is great for PHP Laravel applications. Special attention to the environment variables flexibity (check out the section down this README).

#### Simple usage

[](#simple-usage)

To start the services:

```
fwd start
```

To stop the services:

```
fwd stop
```

Note: stopping will destroy all your containers, as they should all be ephemeral. Don't worry, important data should always be stored in volumes so they are kept amongst containers generations.

#### Other commands

[](#other-commands)

There is a bunch of commands delivered out of the box. You can check a list of all of them by running `fwd` without other arguments to see the help message.

A couple of examples:

```
# PHP projects
fwd composer install # runs PHP Composer
fwd artisan migrate:fresh --seed # runs Laravel artisan CLI tool

# JS projects
fwd yarn install # runs Yarn install
fwd yarn dev     # runs a package.json defined script

# Custom docker and docker-compose
fwd docker-compose logs -f http # tails the logs of the http service

```

Environment variables
---------------------

[](#environment-variables)

`fwd` is very flexible for you to tweak and change behaviors using environment variables. Variables like `FWD_HTTP_PORT` that holds the port `http` service will bind to, for example, can easily be changed in a number of ways, find the one that best fits your needs.

The precedence is as follows (from the highest to the lowest precedence):

1. In-line/exported environment variables. (i.e `FWD_DEBUG=1 fwd ...`)
2. `.env` file in the current working directory (dotenv file format; usually not versioned in your project).
3. `.fwd` file in the current working directory (this file holds project specific `fwd` settings that usually are versioned with the project).
4. `$HOME/.fwd` file; so you can have user-system specific changes easily across the board if needed.
5. Defaults `.fwd` distributed file bundled in `fwd` CLI; subject to changes with new versions.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~11 days

Total

44

Last Release

2131d ago

Major Versions

v0.26 → v1.0-rc.12019-11-16

PHP version history (3 changes)v0.1PHP ^7.1.3

v1.0-rc.2PHP ^7.2

v1.0-rc.8PHP ^7.2.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/347400?v=4)[Daniel Polito](/maintainers/dbpolito)[@dbpolito](https://github.com/dbpolito)

---

Top Contributors

[![dbpolito](https://avatars.githubusercontent.com/u/347400?v=4)](https://github.com/dbpolito "dbpolito (184 commits)")[![fabriciojs](https://avatars.githubusercontent.com/u/1116377?v=4)](https://github.com/fabriciojs "fabriciojs (109 commits)")[![gabrielboliveira](https://avatars.githubusercontent.com/u/11093090?v=4)](https://github.com/gabrielboliveira "gabrielboliveira (93 commits)")[![danielsuguimoto](https://avatars.githubusercontent.com/u/25229545?v=4)](https://github.com/danielsuguimoto "danielsuguimoto (15 commits)")

---

Tags

dockerlaravellocal-developmentphpvesselcliconsoleframeworklaravellaravel-zerodockerdocker-composefwd

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/fireworkweb-fwd/health.svg)

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

###  Alternatives

[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)

PHPackages © 2026

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