uniVocity is available for download without any restriction and is free for non-commercial use. However, if you use it without a license file, batch operations are disabled. To experience maximum performance, we suggest you to obtain a license file.

This tutorial is intended for commercial users who wish to test/purchase uniVocity licenses.

You can get a free 30-day trial immediately by simply creating a license request for your computer and sending it to us. The license file is generated from computer on which uniVocity will be executed. In order to request a license, you must execute a license request script.

If you downloaded uniVocity directly from our website, you can simply run appropriate license request scripts under univocity-[version]-RELEASE/license_request/. There, you will find the following scripts:

  1. launch_gui : will start a graphical wizard to generate your license request.
  2. launch_cmd : will start command-line prompt to generate your license request. Use this if you are using a server and you don't have a graphical interface available. When using the command-line license request, you can provide a properties file with pre-filled information, to make it easy to generate license requests for multiple computers (this will be discussed in detail later).

If you downloaded uniVocity directly from our maven repository into your workspace, simply execute one of the following classes from the univocity-[version].jar, as regular java applications:


This is the graphical license request wizard, which you can use if you have a graphical interface.


The command-line license request script which can be used in servers and computers without a graphical user interface.

License options and information

As soon as the script is started, the license agreement will be displayed. You must agree to the uniVocity license terms and conditions in order to obtain a license file and use the software. If you agree to proceed, you will be asked to provide the following information:

  • License type There are 3 types of license:
    • evaluation - request a free 30-day trial license and execute uniVocity with no limitations for that period.
    • development - request a development license. uniVocity will limit batches to 50 rows per batch.
    • enterprise - request an enterprise license - no limitations.
  • Order number (for non-evaluation licenses) The order number you received after completing the license purchase at our website
  • E-mail address the e-mail address of the account used to purchase your license(s) at our website, or if you are requesting an evaluation license, your personal e-mail address
  • Company name your company name
  • License term You can choose:
    • perpetual - get a license you can use forever. Once your host is decommissioned, you can transfer your license to a new host at no cost. However, this license does not allow upgrades to major releases.
    • annual - register your host for a given number of years. You can renew your annual license when required.
    Note: you can transfer your license at no cost every 2 years.
  • Years (for annual license term) The number of years during which your host will be able to execute uniVocity with the license you are requesting.
  • Upgrade support There are 4 options to choose from:

    • major - You can upgrade to a new uniVocity release with significant new functionalities, and up-to-date technologies.
    • minor - You can upgrade to minor releases of uniVocity, which include additional features to the current major release stream.
    • maintenance - You can upgrade to maintenance releases of uniVocity, which include corrections and improvements, but no new features.
    • none - You cannot upgrade your current uniVocity release. Use this if you are confident your application is stable enough and won't require further updates in the near future. You can obtain a new license later if required.

    After providing all this information, a machine signature will be generated and you will receive a message similar to the following:

      Thank you! Your uniVocity license request has been successfully generated.
      This is your license request file: /home/yourname/univocity/REQUEST_YOURNAME_AT_YOUR-HOST.LIC
      NOTE: you can send license requests in bulk. To do this:
          * Add multiple license request files into a zip file,
          * Attach multiple license request files into an e-mail,
          * Copy and paste the contents of multiple license requests into the body of an e-mail (as text).
      Send your license requests to licenses@univocity.com and we will send your license as soon as possible.


    The file contains the answers you gave to the questions presented earlier, and some data about your computer. It should look similar to the following:

            License request for uniVocity
      Version 1.0.0 (enterprise)
      Upgrade support: major
      Register to: Your Company Ltd (you@yourcompany.com)
      License Term: annual - 5 years
      Order number: 123456
      Host name: your-laptop
      User name: yourname
      Host signature:
      |/RtVFS2i                                |

The host signature is generated based on your computer's hostname, username, MAC address, operating system and number of processor cores. This signature is used to generate a license key specifically for your host. The license key is valid for your specific host signature and will become invalid if any of this information changes (username excepted). Your licenses can be transferred to new hosts every two years.

How your license requests are processed

To receive your license key, simply send the license request (file or text content) via e-mail to licenses@univocity.com. You can send multiple license requests via e-mail in plain text, by attaching multiple request files, or by attaching zip files containing all requests.

We will process your license request and send a zip file with your license. If you purchased multiple licenses, you will receive a single zip file containing all licenses, allowing you to transfer the same file to each host.

Requests for evaluation licenses will generally be processed almost immediately and will be valid for 30 days. Requests for purchased licenses will be processed as soon as we receive payment confirmation. Additionally, requests for purchased orders will be validated against your purchase made in our website. Company name, e-mail address and order number in each request must match your details in our website.

The license file for your host will look like this:

    Product: uniVocity v1.0.0 (enterprise) 
    Upgrade support: major 
    Registered to: Your Company Ltd (you@yourcompany.com)
    License Term: annual - 5 years (from 2014-Aug-01)
    Order number: 123456
    Host name: your-laptop 
    User name: yourname 

    Host signature 
    |/RtVFS2i                                |

    License key (valid until 2019-Aug-01) 
    |yj2d0TN4+CzlhPo5z1KzIQ==                | 


Once you receive your license.zip file, all you need to do is to place it in your classpath so uniVocity can validate it and start up. You can also place the license file anywhere in your computer and invoke Univocity.setLicensePath("/path/to/your/license.zip"); before starting the data integration engine.

We will send e-mails with licenses to the addresses that sent each license request, as well as the e-mail specified in each license request itself. If you want to centralize all licenses to your e-mail, make sure you are the only person sending license requests to licenses@univocity.com.

If you purchased multiple licenses, you don't need to send all license requests at once. Simply send the requests you have at any time and we will send you the corresponding licenses. Once you send more license requests, you will receive a zip file with the licenses for the previous and current requests. Licenses will be grouped in a zip file for a single order. As soon as you make a new purchase, you will receive a new order number and licenses requests for that order number will have their licenses grouped in their own zip file.

Requesting licenses for multiple hosts

The license request script can use a properties file to pre-fill the information needed to generate a license request. It is very convenient to use this feature if you need to execute the script in multiple hosts.

Simply edit the license_request.properties file to match your requirements and execute the license request script. The following example presents all available options:

    ### The 'interactive' property indicates whether or not the script should ask
    ### the user for a value. If set to 'true' the value in each property will be
    ### be used as default that can be overridden by the user. If set to 'false', 
    ### the script will use the property values without asking any questions. 
    ###  - Accepted values: true, false

    ### Answer to "I have read the License Agreement and accept its Terms and Conditions (Y/N)"
    ###  - Accepted values: 'Y', 'N'

    ### Email address that should receive the license file.

    ### Your name or company name to which the license should be attributed to.
    company.name=Your Company Ltd

    ### Number of the order generated for your purchase. The order number and its details
    ### Should've been sent to your e-mail. 

    ### The type of license purchased on our website (http://www.univocity.com). 
    ### Your order must contain one of the license types.
    ###  - Accepted values: evaluation, development, enterprise

    ### The type of upgrade support associated with the license purchased on our website (http://www.univocity.com). 
    ### Your order must contain a license with one of these upgrade support options.
    ###  - Accepted values: major, minor, maintenance, none

    ### The period in which the license purchased on our website (http://www.univocity.com) is valid. 
    ### Your order must contain a license with one of these license term options
    ###  - Accepted values: annual, perpetual

    ### The number of years in which the license purchased on our website (http://www.univocity.com) is valid. 
    ### Your order must contain annual licenses enough so to fulfill the number of years for this host.    


Once you have your properties file ready, simply execute the command line license request class (com.univocity.LicenseRequest), passing the file location as an argument, and it will pre-fill the information for you. A license file will be generated automatically.

If you have any questions regarding licenses, please send us an e-mail to support@univocity.com