Configuration items available on every instance type

Each instance type (php,java,python,go,ruby…) has its own configuration. However, some of these configuration items can be applied to any instance.

Private SSH key

If your company manages its own artifacts in a private repository (like, you can only access them via git+ssh or sftp), and you need a private key to connect to the server, you can commit them in your application's Clever Cloud repository and then add the clevercloud/ssh.json.

The content of this file is pretty straight-forward:

    "privateKeyFile": "path/to/file"

The privateKeyFile field must be a path to a SSH private key. The path must be relative to the root of your repository. e.g. if your private key file is in the clevercloud folder and is named my_key, the privateKeyFile field will be "clevercloud/my_key".

That key will be installed as ~/.ssh/id_rsa before the start of the build. So the dependency manager will use it to fetch libs only accessible by ssh.

NB: Please provide a key without pass phrase, or the system will be unable to unlock it


You can run specific tasks during the deployment of your application. Please refer to the hooks documentation to learn more about them.


You can run background tasks running in parallel of your application. They will be restarted automatically on error. Those are especially useful for environments where you can't have long-running processes such as PHP, ruby or python.

The workers run in the same environment as your application. They are launched in the application's directory.

All you need to do is add one (or several) envrionment variables as such:




By default, workers will be restarted if they exit with an error code. You can customise this behaviour by setting the environment variable CC_WORKER_RESTART to one of always, on-failure (the default) or no.

Edit me on GitHub