Download distribution

Last modified 17 Jul 2026 06:53 UTC

The download-distribution command downloads the target midPoint distribution from download.evolveum.com and extracts it into the directory specified by the --distribution-directory option.

By default, Ninja downloads the next supported target version based on the current midPoint version. For example:

  • 4.7.1 → 4.8

  • 4.4.6 (LTS) → 4.8

The download-distribution command takes the following options:

Option Description

--distribution-directory <PATH_TO_DIRECTORY>

Specifies the directory to which the distribution is extracted. If not specified, the distribution is extracted to <midPoint-home>/tmp.

--distribution-version <VERSION>

Specifies the version of the distribution to download.
Version formats x.x and x.x.x are accepted, e.g., 4.9 or 4.10.1.
If not specified, Ninja downloads the next supported target version based on the current midPoint version.
For example, if the current midPoint version is 4.7.1, Ninja downloads version 4.8, and if the current midPoint version is 4.4.6 (LTS), Ninja downloads version 4.8.
Alternatively, to download the latest development (snapshot) build, use --distribution-version latest. Note that the latest development build may not be as stable as an official release.
For more information on release versions, see Container Images Naming Conventions.

--distribution-archive <PATH_TO_ZIP>

Specifies the path to an existing ZIP archive of the distribution. If specified, Ninja uses the provided archive instead of downloading it from download.evolveum.com, and extracts it in the directory specified by --distribution-directory.
This is useful if you already have the required distribution archive available locally, for example, a previously downloaded release, or a custom build created using a Maven overlay. It is also useful when used together with the upgrade-distribution command.

--temp-dir <PATH_TO_DIRECTORY>

Specifies the directory used for temporary files during the download and extraction process. If not specified, the default JVM temporary directory is used.`
Example downloading the default target distribution
./bin/ninja.sh download-distribution \
  --temp-dir .upgrade \
  --distribution-directory .upgrade/new-distribution
Example downloading the latest available development build
./bin/ninja.sh download-distribution \
  --temp-dir .upgrade \
  --distribution-directory .upgrade/latest-distribution \
  --distribution-version latest
Was this page helpful?
YES NO
Thanks for your feedback