PHPackages                             unleashedtech/deployer-recipes - 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 &amp; Deployment](/categories/devops)
4. /
5. unleashedtech/deployer-recipes

ActiveDeployer-recipe[DevOps &amp; Deployment](/categories/devops)

unleashedtech/deployer-recipes
==============================

Deployer 7+ functionality used by Unleashed Technologies

0.5.0(3y ago)35.9k2[2 PRs](https://github.com/unleashedtech/deployer-recipes/pulls)MITPHPPHP ^7.3 || ^8.0CI passing

Since Aug 30Pushed 3y ago9 watchersCompare

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

READMEChangelog (10)Dependencies (4)Versions (49)Used By (0)

UT Deployer Recipes
===================

[](#ut-deployer-recipes)

[![Latest Version](https://camo.githubusercontent.com/071d0e2be7e3be7047a6c4772e49ecaa7ef47304df19b0fe32266b265bf15c08/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f756e6c656173686564746563682f6465706c6f7965722d726563697065732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/unleashedtech/deployer-recipes)[![Software License](https://camo.githubusercontent.com/c2bffd81d308ced1cc3b0d66fb0ed453ab478a5e17c988b780f9de986a390ee2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Build Status](https://camo.githubusercontent.com/ff98d55012dd53eaea33720a88d84f1ec23280df91aaa3d8f8817be9103afe4f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f756e6c656173686564746563682f6465706c6f7965722d726563697065732f746573742f6d61696e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/unleashedtech/deployer-recipes/actions?query=workflow%3Atest+branch%3Amain)

This package uses Deployer 7, which supports recipes defined by YAML or PHP.

Deployer will import the recipes in a linear fashion. Placeholders will be replaced with actual values as late as possible. Deployer looks for `deploy.php` or `deploy.yaml` when run.

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

[](#installation)

All recipe paths have been adjusted to use the files in the vendor directory and thus should be installed with composer:

```
composer require unleashedtech/deployer-recipes
```

Usage
-----

[](#usage)

Recipes have been organized to easily support any version of any software. They make several assumptions about git repository settings, deployment locations &amp; host settings. These [assumed default values](config.php) are only applied if you haven't already defined them. Please choose a platform below for more.

- [Drupal](cms/drupal)
- [Magento](cms/magento)
- [WordPress](cms/wp)

Please note that tasks assume databases on relevant stages have already been configured. If you need to skip all database operations, you can set `skip_db_ops` to `true` [via the command line](https://deployer.org/docs/7.x/cli#overriding-configuration-options).

Run `vendor/bin/deployer.phar tree deploy` to view the `deploy` recipe tree.

Run `vendor/bin/deployer.phar deploy` to deploy.

Run `vendor/bin/deployer.phar` to review available recipes.

### Before/After Hooks

[](#beforeafter-hooks)

Deployer supports running tasks before or after other defined tasks. Defining custom tasks to trigger before &amp; after other defined tasks is trivial. Such functionality can be added to the end of `deploy.yaml`, as shown below:

```
tasks:
    foo:
        script:
            - "echo 'foo'"
    bar:
        script:
            - "echo 'bar'"

after:
    deploy:symlink: foo

before:
    deploy:unlock: bar
```

### SSH Hosts

[](#ssh-hosts)

This package will dynamically define hosts based on global configuration values. It loops over a CSV list of environments in the `environments` variable, defining 0 or more hosts for each environment. By default, `production`, `staging` &amp; `dev`environments are defined. For each environment, the package defines a number of hosts based on the integer value of the matching `{environment}_webservers`variable (e.g. two hosts defined for `production` based on the `production_webservers`variable value). These hosts will be linked together by their environment name (or `stage`, in Deployer parlance). When you want to deploy to production, you would probably run a command similar to `dep deploy stage=production`. This package assumes there are 2 production webservers, by default.

```
config:
    ####
    production_domain: "production1.example"
    production_webservers: 3
```

#### Configuring SSH

[](#configuring-ssh)

The hosts defined by Deployer are merely aliases. During execution, Deployer will assume hosts defined internally are available via SSH. You can add hosts to your `~/.ssh/config` file, or you can add [Include](https://man.openbsd.org/ssh_config#Include)directive(s) which will load config provided by other files into your main SSH config. Such definitions can occur immediately before an automated deployment.

Each *project* can provide its own SSH config. Consider creating an `.ssh` folder in your project root &amp; creating a `config` file within.

You can manually include config for *specific* projects:

```
Include ~/projects/foo/.ssh/config

```

You can also use a pattern to auto-include project config from *many* folders:

```
Include ~/projects/*/.ssh/config

```

References
----------

[](#references)

- [Deployer 7 Documentation](https://deployer.org/docs/7.x/getting-started)
- [Default Deployer 7 Configuration](https://github.com/deployphp/deployer/blob/master/deploy.yaml)
- [Install and configure Deployer](https://lorisleiva.com/deploy-your-laravel-app-from-scratch/install-and-configure-deployer)
- [Create Your Own Deployer Recipes](https://lorisleiva.com/deploy-your-laravel-app-from-scratch/create-your-own-deployer-recipes)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 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

Recently: every ~56 days

Total

37

Last Release

1297d ago

PHP version history (2 changes)v0.1.2PHP ^7.2.5 || ^8.0

0.1.7PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4325b62a6ad366c731c3120595d861469be50f9da88df3ea99752c30ff98c179?d=identicon)[colinodell](/maintainers/colinodell)

![](https://www.gravatar.com/avatar/1b4a05f5f91f08040a5da3529f35a62560c72fe9dbcc6609d11519f44cb30425?d=identicon)[dl-unleashed-technologies](/maintainers/dl-unleashed-technologies)

---

Top Contributors

[![dshumakerUT](https://avatars.githubusercontent.com/u/84193609?v=4)](https://github.com/dshumakerUT "dshumakerUT (127 commits)")[![dl-unleashed-technologies](https://avatars.githubusercontent.com/u/48725574?v=4)](https://github.com/dl-unleashed-technologies "dl-unleashed-technologies (116 commits)")[![danshumaker](https://avatars.githubusercontent.com/u/358833?v=4)](https://github.com/danshumaker "danshumaker (37 commits)")[![colinodell](https://avatars.githubusercontent.com/u/202034?v=4)](https://github.com/colinodell "colinodell (18 commits)")[![uthha](https://avatars.githubusercontent.com/u/173171824?v=4)](https://github.com/uthha "uthha (2 commits)")

---

Tags

deployerrecipe

### Embed Badge

![Health badge](/badges/unleashedtech-deployer-recipes/health.svg)

```
[![Health](https://phpackages.com/badges/unleashedtech-deployer-recipes/health.svg)](https://phpackages.com/packages/unleashedtech-deployer-recipes)
```

###  Alternatives

[sourcebroker/deployer-extended

Library with some additional tasks for deployer (deployer.org).

25275.4k9](/packages/sourcebroker-deployer-extended)[ngmy/webloyer

Webloyer is a Web UI for managing Deployer deployments

2181.1k](/packages/ngmy-webloyer)[sourcebroker/deployer-extended-typo3

Customisation for `sourcebroker/deployer-typo3-\*` stack

38201.6k2](/packages/sourcebroker-deployer-extended-typo3)[innocenzi/deployer-recipe-forge

Seamless zero-downtime deployment on Forge with Deployer

1916.6k](/packages/innocenzi-deployer-recipe-forge)[sourcebroker/deployer-extended-wordpress

Deployment for WordPress with deployer.org.

232.8k](/packages/sourcebroker-deployer-extended-wordpress)[sourcebroker/deployer-extended-wordpress-composer

Composer based WordPress deployment with deployer.org.

155.4k](/packages/sourcebroker-deployer-extended-wordpress-composer)

PHPackages © 2026

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