maven (48) Versions 7.0.1 Follow52

Custom resources for installing Apache Maven and downloading Maven artifacts

Policyfile

Berkshelf

Knife

cookbook 'maven', '~> 7.0.1', :supermarket

cookbook 'maven', '~> 7.0.1'

knife supermarket install maven

knife supermarket download maven

README

Dependencies

Changelog

Quality 50%

maven Cookbook

Custom resources for installing Apache Maven, downloading Maven artifacts, and
editing settings.xml.

Use the custom resources directly:

maven_install
maven_artifact
maven_settings

This cookbook does not install Java. Ensure a compatible JDK is present before
using the mvn binary or maven_artifact.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community
of Chef cookbook maintainers working together to maintain important cookbooks.
If you'd like to know more please visit sous-chefs.org
or come chat with us on the Chef Community Slack in
#sous-chefs.

Requirements

Platforms

The cookbook metadata currently supports:

AlmaLinux 9+
Amazon Linux 2023+
Debian 12+
Debian 13+
Fedora
Rocky Linux 9+
Ubuntu 22.04+

Chef

Chef Infra Client 16+

Cookbooks

ark 5.0+

Resource Overview

`maven_install`

Installs Apache Maven from the upstream binary tarball, manages the Maven home,
and writes a mavenrc file with M2_HOME and MAVEN_OPTS.

maven_install 'default' do
  version '3.9.14'
end

`maven_artifact`

Downloads an artifact from one or more remote repositories by invoking the
Maven dependency plugin through mvn.

maven_artifact 'mysql-connector-j' do
  group_id 'com.mysql'
  version '8.4.0'
  dest '/opt/app/lib'
end

`maven_settings`

Updates a value in an existing settings.xml file by dotted path.

maven_settings 'settings.localRepository' do
  value '/srv/maven-repository'
end

Usage

Install a supported JDK first, then declare the resources you need in your own
wrapper cookbook. A typical flow is:

Install Java with your preferred cookbook or base image.
Use maven_install to place Maven on the node.
Use maven_settings to adjust settings.xml if needed.
Use maven_artifact to fetch application dependencies or deployment assets.

See test/cookbooks/test/recipes/default.rb for the full default-suite example
that exercises all three resources together.

Resource Documentation

[maven_install](./documentation/maven_install.md)
[maven_artifact](./documentation/maven_artifact.md)
[maven_settings](./documentation/maven_settings.md)

Limitations

See [LIMITATIONS.md](./LIMITATIONS.md) for supported platforms, architecture
notes, and current behavioral constraints of the resources.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Dependent cookbooks

ark >= 5.0

Contingent cookbooks

maven Cookbook CHANGELOG

This file is used to list changes made in each version of the maven cookbook.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

7.0.1 (2026-04-20)

Bug Fixes

preserve destination directory permissions (#184) (a2495d6)

7.0.0 (2026-04-20)

⚠ BREAKING CHANGES

migrate maven to custom resources (#179)

Features

migrate maven to custom resources (#179) (3c2f3b4)

Bug Fixes

ci: Update workflows to use release pipeline (#176) (e61af39)
restore cookbook release workflow (febee91)
update cookbook release workflow (f0fe7b3)

6.0.13 (2025-10-15)

Bug Fixes

ci: Update workflows to use release pipeline (#176) (e61af39)

6.0.6 - 2023-06-08

Standardise files with files in sous-chefs/repo-management

6.0.1 - 2022-02-08

Remove delivery folder

6.0.0 - 2022-01-10

Enable unified_mode and require Chef >= 15.3
resolved cookstyle error: providers/settings.rb:48:34 convention: Style/FileRead

5.4.2 - 2021-08-30

Standardise files with files in sous-chefs/repo-management

5.4.1 (2021-06-01)

Standardise files with files in sous-chefs/repo-management

5.4.0 (2020-11-04)

Sous Chefs Adoption
Update to use Sous Chefs GH workflow
Update README to sous-chefs
Update metadata.rb to Sous Chefs
Update test-kitchen to Sous Chefs

Fixed

resolved cookstyle error: resources/default.rb:52:5 convention: Style/RedundantAssignment
resolved cookstyle error: resources/default.rb:53:5 convention: Layout/IndentationWidth
resolved cookstyle error: resources/default.rb:54:26 convention: Layout/ElseAlignment
resolved cookstyle error: resources/default.rb:55:5 convention: Layout/IndentationWidth
resolved cookstyle error: resources/default.rb:56:26 convention: Layout/ElseAlignment
resolved cookstyle error: resources/default.rb:57:5 convention: Layout/IndentationWidth
resolved cookstyle error: resources/default.rb:58:26 warning: Layout/EndAlignment
resolved cookstyle error: resources/default.rb:59:1 convention: Layout/EmptyLinesAroundMethodBody
resolved cookstyle error: resources/default.rb:59:1 convention: Layout/TrailingWhitespace
resolved cookstyle error: resources/default.rb:28:42 refactor: ChefCorrectness/LazyEvalNodeAttributeDefaults
Yamllint fixes
Add default .mdlrc
Add missing platforms to dokken

Removed

Remove EL 6 testing

5.3.0 (2019-10-07)

Cookstyle fixes - @tas50
Update for Chef 15 license agreement and Chef Workstation - @tas50
Style fixes - @tas50
Resolve Cookstyle 5.8 warnings and require Chef 13+ - @tas50

5.2.0 (2018-07-23)

Remove ChefSpec matchers that are auto generated now
Verify install_ark resource is correctly called
Add ability to install Maven under different user/group and auto create that user/group

5.1.0 (2017-11-28)

Update version of maven installed
Remove java dependency (add to test cookbook)

5.0.3 (2017-11-01)

Fix the archive URL for realz this time

5.0.2 (2017-11-01)

Update the default maven URL to use the apache.org archive site since the binary has been moved off the main site

5.0.1 (2017-05-28)

Close settings.xml file after writing.
Increase requirement to 12.6+ as we can't use action_class.class_eval at this point

5.0.0 (2017-04-26)

Add new setup_bin attribute to allow you to skip adding mvn to the system's path
Test with delivery local mode
Convert default LWRP to a custom resource
Fix readme formatting
Use Maven 3.5.0 by default
Fix Chef 13 compat + why-run support in settings LWRP

4.0.1 (2016-12-06)

Change provider so it only notifies when the artifact actaully changes
Add a matcher for the settings resource
Set the name property using the DSL
Properly set the repositories from attribute in the provider

4.0.0 (2016-09-16)

Force update when downloading snapshots
Require Chef 12.1+
Testing updates

3.0.0 (2016-09-03)

Resolve rubocop warnings
Add use_inline_resources to the providers
Testing updates
Use inspec and remove apt cookbook from testing
Require Chef 12
Remove the Windows cookbook dep which isn't needed in Chef 12

v2.2.0 (2016-04-04)

Add timeout value to the maven resource
Cleanup to how the default action is set in the maven resource
Require a modern Windows cookbook as there are issues with the older releases

v2.1.1 (2016-02-16)

Increase the ark version pin to ~1.0 to bring in the last 2 years of ark changes
Require the latest java cookbook to fix install issues on Ubuntu/Debian and to support the latest OpenJDK releases
Updated all testing dependencies
Updated the platforms that are tested in Test Kitchen

v2.1.0 (2015-11-25)

Added a new settings LWRP for updating maven settings. See the readme for details
Add the group lwrp property to the readme

v2.0.1 (2015-11-16)

Added Chefspec matchers
Updated the LWRP with a new attribute group that defaults to node['root_group'] which enables support for platforms such as FreeBSD and OS X where root's group is not root.

v2.0.0 (2015-11-16)

BREAKING CHANGES:

Support for Maven 2 has been removed. In doing so the attribute structure has been changed. The version attribute now has the complete version string not just the major version. The url and 'checksum' attributes are now top level attributes instead of being under the individual maven versions. See the readme for the up to date attribute structure.
Java is no longer installed by this cookbook. Maven 3 requires JRE 8, which may require installing Oracle Java depending on the age of your platform. The user need to handle the installation of Java by using the java cookbook or their own wrapper cookbook.

v1.3.1

NOTE: This will be the last release with Maven 2 support

Added requirements section to the readme to clarify what distros are supported and the requirement of Chef 11+
Updated .gitignore file
Added Chef standard Rubocop config
Updated Travis CI testing to use Chef DK
Updated Berksfile to 3.x format
Removed the version pin on apt in the Berksfile
Updated Gemfile with the latest development dependencies
Updated contributing and testing docs
Added maintainers.md and maintainers.toml files
Added Travis and cookbook version badges to the readme
Added a Rakefile for simplified testing
Added a Chefignore file
Resolved Rubocop warnings
Added source_url and issues_url to the metadata

v1.3.0

Adding Windows support

v1.2.0

Adding flag to allow Java not to be managed by cookbook

v1.1.0

[COOK-3849] - Update maven 3 to 3.1.1

v1.0.0

Improve /etc/mavenrc template
Install Maven 3.1.0 by default

v0.16.4

Improve repository_root attribute customization
Fix idempotency in LWRP

v0.16.2

The following changes were originally released as 0.16.0, but the README incorrectly referred to the maven# recipes, which are now removed.

[COOK-1874]: refactor maven default recipe to use version attributes
[COOK-2770]: maven cookbook broken for maven3 now that maven 3.0.5 has been released

v0.15.0

[COOK-1336] - Make Transitive Flag Configurable

v0.14.0

[COOK-2191] - maven3 recipe's "version" doesn't match the attributes
[COOK-2208] - Add 'classifier' attribute to maven cookbook

v0.13.0

[COOK-2116] - maven should be available on the path

v0.12.0

[COOK-1860] - refactor maven provider to use resources and shell_out

v0.11.0

[COOK-1337] - add put action to maven lwrp to control name of the downloaded file
[COOK-1657] - fix download urls

v0.3.0

[COOK-1145] - maven lwrp to download artifacts
[COOK-1196] - convert lwrp attributes to snake_case
[COOK-1423] - check version attribute in default recipe

v0.2.0

[COOK-813] - installs maven2 and maven3 using the binaries from maven.apache.org

Collaborator Number Metric

7.0.1 passed this metric

Contributing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

7.0.1 passed this metric

No Binaries Metric

7.0.1 passed this metric

Testing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

maven Cookbook

Maintainers

Requirements

Platforms

Chef

Cookbooks

Resource Overview

maven_install

maven_artifact

maven_settings

Usage

Resource Documentation

Limitations

Contributors

Backers

Sponsors

Dependent cookbooks

Contingent cookbooks

maven Cookbook CHANGELOG

7.0.1 (2026-04-20)

Bug Fixes

7.0.0 (2026-04-20)

⚠ BREAKING CHANGES

Features

Bug Fixes

6.0.13 (2025-10-15)

Bug Fixes

6.0.6 - 2023-06-08

6.0.1 - 2022-02-08

6.0.0 - 2022-01-10

5.4.2 - 2021-08-30

5.4.1 (2021-06-01)

5.4.0 (2020-11-04)

Fixed

Removed

5.3.0 (2019-10-07)

5.2.0 (2018-07-23)

5.1.0 (2017-11-28)

5.0.3 (2017-11-01)

5.0.2 (2017-11-01)

5.0.1 (2017-05-28)

5.0.0 (2017-04-26)

4.0.1 (2016-12-06)

4.0.0 (2016-09-16)

3.0.0 (2016-09-03)

v2.2.0 (2016-04-04)

v2.1.1 (2016-02-16)

v2.1.0 (2015-11-25)

v2.0.1 (2015-11-16)

v2.0.0 (2015-11-16)

v1.3.1

v1.3.0

v1.2.0

v1.1.0

v1.0.0

v0.16.4

v0.16.2

v0.15.0

v0.14.0

v0.13.0

v0.12.0

v0.11.0

v0.3.0

v0.2.0

Collaborator Number Metric 7.0.1 passed this metric

Contributing File Metric 7.0.1 failed this metric Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric 7.0.1 passed this metric

No Binaries Metric 7.0.1 passed this metric

Testing File Metric 7.0.1 failed this metric Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric 7.0.1 failed this metric Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Details

Updated April 20, 2026 Created on November 18, 2010

Supported Platforms

License

`maven_install`

`maven_artifact`

`maven_settings`

Collaborator Number Metric

7.0.1 passed this metric

Contributing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

7.0.1 passed this metric

No Binaries Metric

7.0.1 passed this metric

Testing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number