To setup configuration param use set function, and to get it inside task use get function.

set('param', 'value');

task('deploy', function () {
    $param = get('param');

Each param can be overridden for each host:

    ->set('param', 'new value');

Configuration parameters also can be specified as callback function, which will be executed on remote host on first get call:

set('current_path', function () {
    return run('pwd');

You can use param's values inside run calls with {{ }}, instead of doing this:

run('cd ' . get('release_path') . ' && command');

You can do it:

run('cd {{release_path}} && command');

Common recipe comes with a few predefined config params listed below.

To get list of available params run:

dep config:dump

Show current deployed release:

dep config:current

Show inventory:

dep config:hosts

Below is a list of common variables.


There to deploy application on remote host. You should define this variable for all of your hosts. For example, if you want to deploy your app to home directory:

    ->set('deploy_path', '~/project');


Current hostname. Automatically sets by host function.


Current user name. Default to current git user name:

set('user', function () {
    return runLocally('git config --get');

You can override it in deploy.php for example to use env var:

set('user', function () {
    return getenv('DEP_USER');

user parameter can be used to configure notification systems:

set('slack_text', '{{user}} deploying {{branch}} to {{hostname}}');


Full path to current release directory. Current dir path in non-deploy contexts. Use it as working path for your build:

task('build', function () {
    // ...

By default, working path is release_path for simple task:

task('build', 'webpack -p');


Points to previous release if it exists. Otherwise variable doesn't exists.

task('npm', function () {
    if (has('previous_release')) {
        run('cp -R {{previous_release}}/node_modules {{release_path}}/node_modules');

    run('cd {{release_path}} && npm install');


Use ssh multiplexing for speedup native ssh client.

set('ssh_multiplexing', true);


If hosts declaration have stages, this option allow you to select default stage to deploy with dep deploy.

set('default_stage', 'prod');


You can also set callable as argument if you need some more complex ways to determine default stage.

Having callable in set() allows to not set the value at once when declared but later when used. There is no difference when we assign simple string but when we assign value of function then this function must be called at once if not used as callable. With callable it can be called when used so function which determine variable can be overwritten by user with its own function. This is the great power of having callable in set() instead of direct function calls.

Example 1: Direct function assign in set()

Lets assume that we must include some third party recipe that is setting 'default_stage' like that:

set('default_stage', \ThirdPartyVendor\getDefaultStage());

And we want to overwrite this in our deploy.php with own value:

set('default_stage', \MyVendor\getDefaultStage());

Third party recipe should avoid direct function call because it will be called always even if overwrite it with our own set('default_stage', \MyVendor\getDefaultStage()). Look for next example how third party recipe should use callable in that case.

Example 2: Callable assign in set()

Lets assume that we must include some third party recipe that is setting 'default_stage' like that:

set('default_stage', function() {
    return \ThirdPartyVendor\getDefaultStage();

And we want to overwrite this in our deploy.php:

set('default_stage', function() {
    return \MyVendor\getDefaultStage();

Result is that only \MyVendor\getDefaultStage() is run.


Number of releases to keep. -1 for unlimited releases. Default to 5.


Git repository of application.

To use a private repository it needs to generate a SSH-key on your host and add to the repository as a Deploy Key (a.k.a. Access Key). This key allows your host to pull out the code. Or use can use agent forwarding.

Note that at the first time host can ask to add host in known_hosts file. The easiest way to do it is running git clone <repo> on your host and saying yes.


Allocate TTY for git clone command. false by default. This allow you to enter passphrase for keys or add host to known_hosts.

set('git_tty', true);


Set the --recursive flag for git clone. true by default. Setting this to false will prevent submodules from being cloned as well.

set('git_recursive', false);


Branch to deploy.

If you want to deploy a specific tag or a revision, you can use --tag and --revision options while running dep deploy. F.e.

dep deploy --tag="v0.1"
dep deploy --revision="5daefb59edbaa75"

Note that tag has higher priority than branch and lower than revision.


List of shared dirs.

set('shared_dirs', [


List of shared files.


List of files to copy between release.


List of dirs which must be writable for web server.


Writable mode

  • acl (default) use setfacl for changing ACL of dirs.
  • chmod use unix chmod command,
  • chown use unix chown command,
  • chgrp use unix chgrp command,


Use or not sudo with writable command. Default to false.


Mode for using then writable_mode in chmod. Default: 0755.


Whether to set chmod on dirs recursively or not. Default: true.


User of web server. If this parameter does not configured, deployer try to detect it from process list.


List of paths which need to be deleted in release after updating code.


Use or not sudo with clear_paths. Default to false.


Use or not sudo with cleanup task. Default to false.


Use or not relative symlinks. By default deployer will detect if system supports relative symlinks and use it.

Relative symlink used by default, if your system supports it.


Use or not atomic symlinks. By default deployer will detect if system supports atomic symlinks and use it.

Atomic symlinking used by default, if your system supports it.


Composer action. Default install.


Options for composer.


Array of environment variables.

set('env', [
    'VARIABLE' => 'value',

Read more about task definitions.