Zenaton white logo



To install your Agent on your computer, just type:

curl https://install.zenaton.com | sh
Depending on your configuration, you may be asked for a password to allow global installation of Zenaton.

If you need to deploy the Agent on a particular system like Docker, Heroku, or Clever Cloud, we have some precooked solutions for you.

Update your Agent

To update your Agent to the latest version, just follow the installation instructions above.


The Zenaton Agent can be configured in two different modes:

  • worker mode: this the default mode and the agent will be configured to both send jobs to the engine from your sources and execute jobs.
  • client-only: in this mode, the agent is only configured to send new jobs to the Zenaton engine queues. It will not execute jobs.

To have your Agent listening for tasks to execute, just type:

zenaton listen <parameters>

Your parameters can be in a .env file, then you just need to provide it:

zenaton listen --env=<path/to/.env/file>

or can be inlined:

zenaton listen --<name>=<value>

If you mix both notations, inlined parameters will be prioritized.


env./.envlocation of .env file containing configuration
boot- location of boot file containing initialisation needed to be done before executing a task. This typically depends on your language. See Below.
ZENATON_APP_IDapp_id- Your application id - to listen only workflows started by your application (refer to Zenaton API section);
ZENATON_API_TOKENapi_token- your API token - to prove you have rights to access above application (refer to Zenaton API section);
ZENATON_APP_ENVapp_env- your Zenaton environment - to distinguish workflows launched in production from workflows launched during development - typically "production", "staging", "dev" or your first name).
ZENATON_CONCURRENT_MAXconcurrent_max10 Maximum number of tasks that the Agent can execute concurrently
ZENATON_HANDLE_ONLYhandle_only- List of classes that the Agent should handle and only them - (comma-separated strings). The default behavior is to handle all classes.
ZENATON_HANDLE_EXCEPThandle_except- List of classes that the Agent should NOT handle - (comma-separated strings). The default behavior is to handle all classes.

Boot file

Zenaton Agent will load your boot file before executing required tasks. This boot file should typically require all your workflow definitions. (see the examples-node repository on Github.)

If you use a framework, you may also need to add instructions to boot it.