Citrus
citrusframework.org
- Free plan
- Linux
What Citrus is
Citrus is a free framework for automated integration testing of messaging applications and microservices. Tests can act as clients or servers across multiple interfaces, sequence messages, and validate their contents. Supported endpoints include HTTP, Kafka, JMS, Apache Camel, mail, FTP/SFTP, OpenAPI, SOAP, Docker, Kubernetes, Knative, SQL, and SSH. Citrus checks JSON and XML payloads and elements, supports XML schema and DTD validation, and can validate database data. Test cases can use loops, delays, retries, parallel sections, and timeouts. Tests are written in Java, XML, YAML, or Cucumber BDD features. Citrus integrates with JUnit 5, Cucumber, JBang, Quarkus, Spring Boot, TestNG, and JUnit 4. Setup documentation covers test-scoped Maven dependencies and Gradle. It runs on Linux and requires Java 17 or newer since version 4.0. Citrus is released under Apache License 2.0 and may test commercial applications. The listed plan costs nothing.
Who it suits
Citrus suits teams building automated integration tests for messaging systems, microservices, and enterprise integrations. It is useful when tests need multiple protocols, message validation, or CI/CD framework integration.
Good to know, and what to watch
- Supports many messaging and infrastructure endpoints
- Validates JSON, XML, schemas, DTDs, and databases
- Offers loops, retries, delays, and parallel sections
- Works with Java, XML, YAML, and Cucumber
- Free Apache License 2.0 framework
- Runs on Linux
- Requires Java 17 or newer from version 4.0
- No free trial because the plan is already free
Plans
Every plan and priceCitrus
Free plan
The verdict
Citrus provides protocol coverage and flexible test logic for integration scenarios involving messages and microservices. Its Linux and Java 17 requirements should be checked against the intended test environment.
What the maker publishes
- Build tools
- The download guide describes adding Citrus modules as test-scoped Maven dependencies and lists Gradle setup documentation. source
- Founded
- 2006 source
- Languages
- Tests can be written in Java, XML, YAML, or as Cucumber BDD features. source
- License
- Citrus is published free of charge under Apache License 2.0 and may be used to test commercial applications. source
- Protocols
- Supported endpoints include HTTP, Kafka, JMS, Apache Camel, mail, FTP/SFTP, OpenAPI, SOAP, Docker, Kubernetes, Knative, SQL, and SSH. source
- Purpose
- Citrus is a test framework focused on messaging applications and microservices, for automated integration tests. source
- Runtime requirement
- Since Citrus 4.0, the project requires Java 17 or newer to run. source
- Runtimes
- Citrus integrates with JUnit 5, Cucumber, JBang, Quarkus, Spring Boot, TestNG, and JUnit 4. source
- Support
- The project invites users to contribute, submit feature requests, and report issues through its community repository. source
- Testing
- A test can act as both client and server on multiple messaging interfaces and validate message content. source
- Test logic
- Test cases can sequence messages and use loops, delays, retries, parallel sections, and timeouts. source
- Validation
- Citrus validates message payloads and elements in JSON and XML, supports XML schema and DTD validation, and can validate database data. source
- Who it is for
- Citrus is presented for enterprise integration testing, including testing messaging scenarios and microservices. source
Checked against the maker's pages on 9 Oct 2026.