PHPackages                             mlebkowski/crane - 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. mlebkowski/crane

ActiveLibrary

mlebkowski/crane
================

1.0.1(12y ago)12.9kPHP

Since Dec 3Pushed 12y ago1 watchersCompare

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

READMEChangelog (2)Dependencies (7)Versions (3)Used By (0)

Crane
=====

[](#crane)

Bootstrap your local environment using docker containers & git

Setup
-----

[](#setup)

1. Create your config according to the [schema](/app/crane-schema.json). You can find detailed descriptions there
2. Push your schema to a git repository, for instance: `git@example.com:vendor/crane-project`

Initialize a project
--------------------

[](#initialize-a-project)

1. Install crane on your local machine using [composer](http://getcomposer.org).

    ```
     $ composer global require 'mlebkowski/crane:dev-master'

    ```

    The binary will be put in `~/.composer/vendor/bin/crane`
2. Add project configuration:

    ```
      $ crane project:init git@example.com:vendor/crane-project

    ```
3. Edit the `~/.crane/config.json` to set up the `targets`/`current-target`

Build images
------------

[](#build-images)

This is only required once per target. Docker images will be built from Dockerfiles.

```
$ crane image:build vendor/project-name --verbose

```

If something changes or goes wrong, you may want to use the `--rebuild` flag.

Start the project
-----------------

[](#start-the-project)

Launch all containers.

```
$ crane project:start vendor/project-name --verbose

```

Use `--restart` if something is wrong or images have changed. The main image is always restarted regardless.

Bootstrap the application
-------------------------

[](#bootstrap-the-application)

You may want to bootstrap your app in some way (init the database, setup permissions, etc). Crane is application agnostic, so it does not have any build in mechanism. Id does however provide a `project:command` command. It will SSH into the running container (if `22` port is exposed inside) using the `identity` file as a private key.

To run a bootstrapping command on the main container, for example:

```
$ crane project:command vendor/project-name 'phing -verbose -f /home/main-image-name/build.xml install'  --verbose

```

Permissions
-----------

[](#permissions)

Make sure you have agent forwarding setup for target host. All SSH commands are using the `-A` flag.

Editing files
-------------

[](#editing-files)

You may want to edit the application source files. To do this push to any branch at `ssh://current-target/.crane/vendor-name/project-name/volumes/main-image-name`. There is a `post-receive` hook there that resets the working copy to the pushed commit.

You might as well use `sshfs`, but there are cache’ing and performance issues. *YMMV*.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity64

Established project with proven stability

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

Total

2

Last Release

4537d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8572223899390b494d1282b615009bc2eea5ef1cd6bfc22f6e6b175034dadfe0?d=identicon)[mlebkowski](/maintainers/mlebkowski)

---

Top Contributors

[![mlebkowski](https://avatars.githubusercontent.com/u/848731?v=4)](https://github.com/mlebkowski "mlebkowski (39 commits)")

### Embed Badge

![Health badge](/badges/mlebkowski-crane/health.svg)

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

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[silverstripe/framework

The SilverStripe framework

7213.5M2.5k](/packages/silverstripe-framework)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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