Skip to content


Benerator, the smart way to generate data

.github/workflows/ci.yml Codacy Badge Codacy Badge Maven Central

rapiddweller 'Benerator'

rapiddweller 'Benerator' is a software solution to generate, anonymize, pseudonymize and migrate data for development, testing and training purposes.


rapiddweller 'Benerator' allows creating realistic and valid high-volume test data, used for testing (unit/integration/load) and showcase setup.

Metadata constraints are imported from systems and/or configuration files. Data can be imported from and exported to files and systems, anonymized, or generated from scratch. Domain packages provide reusable generators for creating domain-specific data as names and addresses internationalizable in language and region. It is strongly customizable with plugins and configuration options.

rapiddweller 'Benerator' is built for Java 11.

If you need support for Java 8 or earlier, please consider using the versions <= 1.0.1.

Preface of this manual

This document is supposed to become a complete summary of everything you need of benerator usage, use it efficiently and extend it as you need. This reference is under construction and will update from time to time. Feel free to contribute your ideas in our repo at:

If problems remain unsolved after reading this book, do not hesitate to contact us for help. rapiddweller-benerator-ce is and remains open-source and is provided for free.

If you are interested in additional support, and our premium features, we encourage you to check the website We offer additional services to make your data generation project a success and provide detailed use cases to ease your start into more complex scenarios.

Since you can do quite a lot of different things with Benerator but surely are interested in just a part of it, here's some guidance:

'Goals and Features', introduces you to the goals and features of Benerator.

Find advise on how to install a binary distribution and how to get the sources and set up an IntelliJ/Eclipse project for using, debugging, and customizing Benerator in 'Installation'.

'Data Generation Concepts', 'Descriptor File Format' and 'Advanced Topics' then provide you with a structured and complete introduction into the Benerator descriptor file setup.

Benerator supports a multitude of service provider interfaces (SPIs). It comes along with some implementations for specific business domains (' Domains') and general-purpose classes in 'Component Reference'.

Finally, you are instructed how to write custom SPI implementations in 'Extending Benerator'.