Skip navigation.

Ivy Documentation

Welcome to the official Ivy documentation.

What is Ivy?

Ivy is an agile dependency manager, primarily focused on managing java dependencies.
Ivy is open source and released under a very permissive BSD license.
Ivy has a lot of powerful features, the most popular and useful being its flexibily, integration with ant, and its strong transitive dependencies management engine.
The transitive dependencies management is a feature which let you get dependencies of your dependencies, transitively. In order to address this problematic ivy needs to find metadata about your modules, usually in an ivy file. To find these metadata and your dependencies artifacts (usually jars), Ivy can be configured to use a lot of different repositories.

About this doc

If you browse this documentation from your installation of ivy, you can also check the online version for latest updates and comments. To easily navigate to the online version, you will find a link to the corresponding online version on each page just after the title.

The online version of this documentation is updated periodically, especially when new features are added during development. So if you find something documented here not available in your version of ivy, it may be because it is available only with the latest download.

If you want to view the whole documentation in a single printer-friendly page, please use the printer-friendly link at the bottom of any documentation page in the online documentation.

Other places to go

Check Ivy features.
Read our FAQ.
Ask for help on our forum.
Report bug or feature request in our issue tracking system.
Check external tools and resources.


This documentation is decomposed in 3 main parts:

  • Tutorials
  • The tutorials is the best way to begin to play with ivy. You will easily and quickly learn the basics of Ivy.

  • Reference
  • The reference documentation gives you all the details of Ivy.
    The introduction part is particularly useful: it defines some vocabulary, explains main concepts such as dependency resolvers and patterns, and give an overview on how ivy works internally.
    It's also in the reference doc that you will find all you always dreamed to know about ivy configuration, ivy files, and ivy use (especially with ant).

  • Appendix
  • The appendix section contains a bunch of Ivy related information which is not part of Ivy reference doc.