Standalone Docker Agent

Choosing the docker agent is the quickest way to start running the self-hosted agent.

Running a deployment-agent

1. Download the Docker Configuration(env0.env file) from the Agents tab under Organization > Settings.

2. Create your state encryption key with the format of base64 encoding. (base64 encoding of any string you choose) and add it in env0.env as a new environment variable:
   ENV0_STATE_ENCRYPTION_KEY=<your-base64-encryption-key>
   ℹ️ This value will be used to encrypt and decrypt the environment state and working directory
   ℹ️ Read more about the state encryption key here
3. Run agent:
   docker run --env-file ~/path/to/env0.env ghcr.io/env0/deployment-agent:latest
   ℹ️ env0 has a public docker registry on GitHub which is maintained here.

And that's it!

The agent should be marked as Active and be ready to handle deployments.

📘

Enabling Multi-Concurrency

Do you have multiple deployments waiting to run and you don't want to them to wait?

Each container is designed to handle a single deployment at a time.

To run multiple deployments in parallel, just create another deployment agent using the docker run command. You can run any number of containers to satisfy your deployment needs.

Running a vcs-agent (for on-prem / self-hosted VCS)

In the case that you are using a self-hosted version control such as Bitbucket Server, GitLab Enterprise, GitHub Enterprise, you will need to run the vcs-agent.

It has to run in parallel with the deployment-agent in order to interact with private VCS.

1. Add credentials to the relevant VCS in env0.env file (see variables table below)
2. Run docker:
   docker run --env-file ~/path/to/env0.env ghcr.io/env0/vcs-agent:latest
   ℹ️ env0 has a public docker registry on GitHub which is maintained here.