IBM Maximo Application Suite CLI Utility¶

The CLI comes in two flavours; container image and standalone uvx tool.

Container Image¶

The MAS CLI container image is published to quay.io:

podman run -ti --rm -v ~:/mnt/home --pull always quay.io/ibmmas/cli mas install --help

Tip

If you want to stick with a specific release of the image you can attach a version tag to the docker run command: docker run -ti --rm -v ~:/mnt/home quay.io/ibmmas/cli:21.6.0

The container image provides an out of the box environment for managing MAS on OpenShift, with numerous dependencies pre-installed (see cli-base for details). The Maximo Application Suite Ansible Collection is included in these dependencies, so even if you prefer to drive Ansible directly, the CLI image can be a useful tool:

podman run -ti --rm -v ~:/mnt/home --pull always quay.io/ibmmas/cli ansible-playbook ibm.mas_devops.mas_install_core

Standalone¶

Introduced in 2026, replacing the standalone binary built with PyInstaller, the mas-cli is now compatible with uv and is the easiest way run the CLI yet.

Install uv

Ephemeral Execution¶

Run the MAS CLI without any install:

uvx mas-cli --help

Persistent Installation¶

Install the MAS CLI globally:

# Install the latest version of mas-cli
uv tool install mas-cli

# The 'mas-cli' command is available in your PATH
mas-cli --help

# Upgrade or uninstall the mas-cli
uv tool upgrade mas-cli
uv tool uninstall mas-cli

Choosing a specific version

You can use a specific version of mas-cli by with ephemeral execution or installation using mas-cli@21.6.0

Function support¶

Not all functions supported in the container image are available in the standalone CLI (yet):

CLI Function	container	uvx
install	✅	✅
aiservice-install	✅	✅
update	✅	✅
upgrade	✅	✅
uninstall	✅	✅
must-gather	✅	✅
backup	✅	✅
restore	✅	✅
mirror	✅	✅
mirror-images (deprecated)	✅	❌
mirror-redhat-images	✅	❌
configure-airgap	✅	❌
setup-registry	✅	❌
teardown-registry	✅	❌
configtool-oidc	✅	❌
provision-aws	✅	❌
provision-fyre	✅	❌
provision-roks	✅	❌