Download

Citrus 4.2.0 is the latest stable release . You may also go for the latest snapshot versions of Citrus always being up-to-date with development changes. Citrus is available on Maven central repository so you can add Citrus as Maven dependency to your project. All available versions and production releases for manual download are listed below:

Release artifacts

Version Release date Sources
4.2.0 2024-03-25 zip/tar.gz
4.1.1 2024-01-25 zip/tar.gz
4.1.0 2024-01-17 zip/tar.gz
4.0.2 2023-11-22 zip/tar.gz
4.0.1 2023-11-13 zip/tar.gz
4.0.0 2023-10-25 zip/tar.gz
3.4.0 2023-01-27 zip/tar.gz
3.3.1 2023-01-10 zip/tar.gz
3.3.0 2022-08-26 zip/tar.gz
3.2.1 2022-04-05 zip/tar.gz
3.2.0 2022-03-04 zip/tar.gz
3.1.2 2022-01-12 zip/tar.gz

Since Citrus 4.0 the project requires Java 17 (or newer version) to run.

Maven

You can easily use Citrus in a Maven project by defining test-scoped dependencies. Simply add the ConSol Labs repository and the following dependencies to your POM (pom.xml). See also our Maven tutorial for a detailed description.

The Citrus core module dependency.

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-core</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

In case you need Citrus modules add following dependencies. See also our modules section for more information on Citrus modules:

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-jms</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-http</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-ws</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-websocket</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-camel</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-ssh</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.citrusframework</groupId>
  <artifactId>citrus-vertx</artifactId>
  <version>4.2.0</version>
  <scope>test</scope>
</dependency>

Use the latest snapshots

Stable releases are available on Maven central repository. We also provide nightly snapshot releases that are available on ConSol Labs repository. So if you want to use the latest snapshot releases of Citrus please add the following repository to your Maven POM.

<repository>
  <id>consol-labs-snapshots</id>
  <url>http://labs.consol.de/maven/snapshots-repository/</url>
  <snapshots>
    <enabled>true</enabled>
    <updatePolicy>10080</updatePolicy>
  </snapshots>
  <releases>
    <enabled>false</enabled>
  </releases>
</repository>

Logging framework notice

We use SLF4J as logging abstraction framework, which means that you as a user are not forced to use a specific logging implementation. SLF4J is similar to commons-logging, so you may use whatever logging framework you want to. All you have to do is add an SLF4J logging implementation to your classpath.

In case you are currently using log4j2 as logging framework just include slf4j-log4j12.jar on your classpath and Citrus will use log4j2 too. If you want to use some other framework than please see the SLF4J documentation for help.