Connection Configuration

Most of Zuul’s configuration is contained in the git repositories upon which Zuul operates, however, some configuration outside of git repositories is still required to bootstrap the system. This includes information on connections between Zuul and other systems, as well as identifying the projects Zuul uses.


In order to interact with external systems, Zuul must have a connection to that system configured. Zuul includes a number of drivers, each of which implements the functionality necessary to connect to a system. Each connection in Zuul is associated with a driver.

To configure a connection in Zuul, select a unique name for the connection and add a section to zuul.conf with the form [connection NAME]. For example, a connection to a gerrit server may appear as:

[connection mygerritserver]

Zuul needs to use a single connection to look up information about changes hosted by a given system. When it looks up changes, it will do so using the first connection it finds that matches the server name it’s looking for. It’s generally best to use only a single connection for a given server, however, if you need more than one (for example, to satisfy unique reporting requirements) be sure to list the primary connection first as that is what Zuul will use to look up all changes for that server.