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_onlyall List of classes that the Agent should handle and only them - (comma-separated strings)
ZENATON_HANDLE_EXCEPThandle_exceptnone List of classes that the Agent should NOT handle - (comma-separated strings)

Boot file

The Zenaton Agent will load your boot file before executing required tasks. This boot file should typically require all your workflow definitions and tasks when these are dispatched from outside a workflow. (see the examples-python repository on Github.)

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


If you are using Django, you should write a script to setup Django (e.g django_setup.py) containing:

import django
import os

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_example.settings')

Then import this script in your boot file and in the script your are dispatching your Workflows from: import setup_django. This will boot the Django framework when needed.

You could include the Zenaton client initialization instructions in the ready() function of your AppConfig.

You can find a full working example of Zenaton's integration with Django here.