Welcome to the Maven Handbook!

Dig in

A constantly improving Maven reference!

The Maven Handbook is a community-written book for everyone using Apache Maven.

From the first mvn verify to settings, the POM, the build lifecycle and best practices: we explain how Maven really works, so your builds stop being magic and start being boring (in a good way).

Learn Maven the right way!

Start with the basics and work your way up. The book follows the path a build takes: common concepts, settings and environment, the Project Object Model and the build lifecycle, finishing with the grand picture.

Understand, not just copy-paste!

Snippets found online work until they don’t. Here you learn why Maven behaves the way it does, so you can reason about your own builds and fix them with confidence.

Apply best practices!

Keep your builds fast, reproducible and easy to maintain. Learn the practices that save you (and your colleagues) from debugging builds at 3am.

This book is written in the open, and you can help write it.

Plain Markdown

The book is built with Hugo and Docsy, and every page is plain Markdown: spotted a typo? Just click “Edit this page”.

Contributions welcome!

We write on GitHub, all in the open. Fixes, new chapters and translations are always welcome, no matter how small!

Read more

Discuss your Maven questions with us!

Missing a topic or something is unclear? Ask us, and it may become the next chapter. No question is too basic.

Read more

…and this is just the beginning.