Release notes from cloudstack-cloudmonkey

CloudMonkey v6.5.0

2025-09-01T10:19:28Z

This release includes:

- Adds support for template/ISO file upload
- Adds support for Two-Factor Authentication (2FA) prompts
- Improves autocompletion filtering and listing for different resources, with name/detail-based suggestions
- Enables sending API requests using HTTP POST
- Improves output formatting for multiple formats and asynchronous APIs
- Enhances filtering output, with support for async APIs and reverse filtering via the excludefilter option
- Updates inbuilt API precache to ACS v4.21
- Improves credential fallback for command-line scenario
- Hardens file permissions for config and history file access
- Improves validation when setting configuration values
- Improves overall linting, tests, and automated workflows for the repository

Installation instructions for Linux/Mac OSX:

1. wget <file url>
2. chmod +x <cmk binary file>
3. mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.5.0 (build: 20c53ca, 2025-08-26T18:58:41+0530)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command-line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode
  -c        Different config file path
  -u	    CloudStack's API endpoint URL
  -s	    CloudStack user's secret Key
  -k	    CloudStack user's API Key

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

MD5 (cmk.darwin.arm64) = fd3cb54b1c9aa4050b4a816800a4423a
MD5 (cmk.darwin.x86-64) = ce2c832291127e0485b4560c930641f3
MD5 (cmk.linux.arm32) = 53728cd22bf93212b2ba88963e98be5d
MD5 (cmk.linux.arm64) = 8e5ebf1957eb0b73ddd5b0855b0574a4
MD5 (cmk.linux.x86) = d501146be52d1a2688df64f013c3fe82
MD5 (cmk.linux.x86-64) = 6ab9a27072b881b8849752fd6ed7606d
MD5 (cmk.windows.x86-64.exe) = 847128c4a2c6c61df183d72c46373b39
MD5 (cmk.windows.x86.exe) = 42758b1e06ac4742a5f4378ed20dfd08

SHA-256 checksums:

SHA-256 (cmk.darwin.arm64) = 056a03bbed99050aceab5fe32489c9ec4bcb143c6accebfb49f3ec34bd974998
SHA-256 (cmk.darwin.x86-64) = 11cb907ec7331e95169c8d75c3e3f70c92268f9b42036ce1df435791ddeb3847
SHA-256 (cmk.linux.arm32) = 0ac271fe57a4c8e24d8e99b95e1ff1ab73918c492892da9905459d60b3df0738
SHA-256 (cmk.linux.arm64) = 7885515c33630e45d94ade05847fd0110a9972b7f2650799d12f23432cee7cef
SHA-256 (cmk.linux.x86) = 73f3f4cf9f419c1fcd3266cf3f1ddeb7b9063de9b6688296fbdba3bb5896dab1
SHA-256 (cmk.linux.x86-64) = 0861cb684acce4b92caea65a9d2b048a96d3599b05e7772c87743884bf1c706c
SHA-256 (cmk.windows.x86-64.exe) = 90a83de5ded1087b8f94700c47ae0addc35be6f78f5fc6f3e58f09dd499e8f6e
SHA-256 (cmk.windows.x86.exe) = 45d8590f7f453c6b9ee2ee31c6875564320dbd35b321385eba3312c4fc6172cc

Full Changelog: 6.4.0...6.5.0

CloudMonkey v6.4.0

2024-03-28T04:23:36Z

This release includes:

- Improve CLI mode usage and output handling
- Add support for http POST handling for password and user-data
- Optimise async API jobs polling
- Better interrupt handling of Ctrl+C to cancel on-going API request but not
  crash `cmk`
- Remove unnecessary call to listApis (sync) when using CLI mode with url,
  api key, secret key
- Updates inbuilt API precache to ACS v4.19

Installation instruction for Linux/Mac OSX:

1. wget <file url>
2. chmod +x <cmk binary file>
3. mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.4.0 (build: df65df7, 2024-03-21T16:03:36+0530)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode
  -c        Different config file path
  -u	    CloudStack's API endpoint URL
  -s	    CloudStack user's secret Key
  -k	    CloudStack user's API Key

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

MD5 (cmk.darwin.arm64) = 86461a687acdfdfa9516c6b4dd69462d
MD5 (cmk.darwin.x86-64) = a6f1b3a96ad3befd1843b7d7b790a521
MD5 (cmk.linux.arm32) = 2cc72a1c4450dd1e5ee67997339afe29
MD5 (cmk.linux.arm64) = 916ea0fc73029675cfeac970f5cf97df
MD5 (cmk.linux.x86) = ad25115dd2a93158e7d2bf8bfa0de259
MD5 (cmk.linux.x86-64) = ac043411e1827341551bbcf13b7c4817
MD5 (cmk.windows.x86-64.exe) = e61d1fb8583f3a3507002b4e01198010
MD5 (cmk.windows.x86.exe) = 94bb9524dfb24efa8f4fbeefaefef07e

SHA-256 checksums:

ee8956b96ba8e2567499b435221dcb7bab3e4ae2321ee79efee1bd9779b2bc59  cmk.darwin.arm64
402f4c6604cae27e57d1c72cb694e1f76209ca36b7d50b12302d43ff780cf960  cmk.darwin.x86-64
6e45a44b765dbbfea3acd90546c6065f63554df46bf97ac9d6387a49773ddb87  cmk.linux.arm32
f0b9878ae759530dd50e71d1df60186c03d8d8b6e6862c66fc3ea2103337ee26  cmk.linux.arm64
d667201787c655ce5f9d5be4f98fd9dc614f5ebdbe1a2f0190d6bdb3f6e658e2  cmk.linux.x86
8458d4fae5b805845b41479b3a83a384bef72317a08221ce44df8d816bee01ae  cmk.linux.x86-64
467cb6ffd2687e1c63946fffc11168bb8a4bcd9234e5dee652a9f05747e9e5d9  cmk.windows.x86-64.exe
21e042b8b8506f3f8b2bb7378e0c7ec155bcae49285f6b5e326afe64169117c2  cmk.windows.x86.exe

Full Changelog: 6.3.0...6.4.0

Pre-Release Testing - CloudMonkey v6.4.0 (Pre-RC)

2024-03-21T10:32:00Z

This is a pre-release RC, with latest build from main.

Installation instruction for Linux/Mac OSX:

1. wget <file url>
2. chmod +x <cmk binary file>
3. mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.4.0-rc (build: 2d641ae, 2023-08-03T14:12:21+0530)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode
  -c        Different config file path
  -u	    CloudStack's API endpoint URL
  -s	    CloudStack user's secret Key
  -k	    CloudStack user's API Key

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

MD5 (cmk.darwin.arm64) = eafbd072aa25aefa139ba130f167c0be
MD5 (cmk.darwin.x86-64) = d9e4de7b3cac99b114d476a0502703fe
MD5 (cmk.linux.arm32) = 4a2d4e9d15435fe28d47d2d34565eaf7
MD5 (cmk.linux.arm64) = f50ff4094ebece46c3b89271d1a75195
MD5 (cmk.linux.x86) = 5d748ffe548cd92dad0428926043ed87
MD5 (cmk.linux.x86-64) = 80b3f88ba358d292a7d9767be0e70d3b
MD5 (cmk.windows.x86-64.exe) = a430109fa85c8cc8b02c5cf9071cc6a4
MD5 (cmk.windows.x86.exe) = 53017a4af2711c2f644142e32eafa3d1

CloudMonkey v6.3.0

2023-05-10T06:46:49Z

This release includes:

- Fixes handling of invalid timeout value
- Fixes csv output
- Add support for ARM64 Darwin/OSX build in Makefile
- Autocompletion on storage pool related APIs
- Enable profile information passing through commandline
- Profile caching improvements and bugfixes
- Fix: reuse cmk's CLI params to call piped cmd
- Maintenance changes - github actions/travis migration, dependencies upgrades,
- Various bug fixes

Installation instruction for Linux/Mac OSX:

1. wget <file url>
2. chmod +x <cmk binary file>
3. mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.3.0 (build: 860771a, 2023-04-28T15:19:52+0300)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode
  -c        Different config file path
  -u	    CloudStack's API endpoint URL
  -s	    CloudStack user's secret Key
  -k	    CloudStack user's API Key

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

MD5 (cmk.darwin.arm64) = 1e9768e47350da347e5dae9c84db60e7
MD5 (cmk.darwin.x86-64) = 132b6e32bf24f5c4472c7db31a12c4b9
MD5 (cmk.linux.arm32) = fc881649ff02c91eb28f0a83229125f2
MD5 (cmk.linux.arm64) = 8dfc3b284ee12b7c2564b9cf1bb47cb8
MD5 (cmk.linux.x86) = 6f0a0776fdd0acd010f919413937c33c
MD5 (cmk.linux.x86-64) = 85616fd8c48648b353065878f78ae7d4
MD5 (cmk.windows.x86-64.exe) = e0f726ce7ce518275dc4f8cad8e8bad3
MD5 (cmk.windows.x86.exe) = b7e7109f6ab8c9899bb0c0635bd66a1c

SHA-256 checksums:

e9c46d508148109a1c0a014784320f0859936ba0cc0f83f63a96a788e91de265  cmk.darwin.arm64
6b66ff6ea80ed0513ccde369ba76cdf59548509a1ce49958c2b275636756a33d  cmk.darwin.x86-64
deb4b2decf1fcdc7b83ca80ad496591e27eb758ba37dbe500471619acaebbb8d  cmk.linux.arm32
49aa257eb5cf6912e8534a8a42a8380553bb1c433ba01b31116096cb733da06c  cmk.linux.arm64
c1a8db48c9171e429d12af63b82df1290bccedd55a477f003b1b0834bc924339  cmk.linux.x86
e79381c2f99c1e15e1ed2d2147e3b288770be9e929d29aa9f89c8138ef899a1d  cmk.linux.x86-64
2f2e788ce9867f01ecaea7a1ccd8b78f3d94869b11d44b476a7bf051e16922cb  cmk.windows.x86-64.exe
d33e5bdf9a866df122adf5da5648022dd3420774e519127036ff2852bbed5a82  cmk.windows.x86.exe

CloudMonkey v6.2.0

2021-10-27T11:47:55Z

v6.2.0 Release Notes:

New option to change default cmk config file
Validation of arguments with limited set of options, while setting cloudmonkey configuration
Verify user access to cloudmonkey configuration file
Allow sync command to be used as a verb for cloudstack API calls
Print response with newlines if output format chosen is "text"
Map "default" output type to "json"
Add autocompletion as an optional configuration
Display output in human readable format
Show meaningful metadata for id autocompletion for some APIs

Installation instruction for Linux/Mac OSX:

wget <file url>
chmod +x <cmk binary file>
mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.2.0 (build: 8aae61e, 2021-09-22T16:26:51+0530)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode
  -c        Different config file path

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

036ada2cf503cead644e20ab272d7080  cmk.linux.x86-64 (Linux Intel-x86 64-bit)
e7bcf7a849a20fdd78e5d3a7ae7c33e4  cmk.linux.x86 (Linux Intel-x86 32-bit)
e9d62d614b7b68efcf999b7ebdd09d75  cmk.linux.arm64 (Linux ARM 64-bit)
0a8c0db65f5df11b32e6d2efb0bc65d1  cmk.linux.arm32 (Linux ARM 32-bit)
479f6c9132c216bfbf0e5e650021f625  cmk.darwin.arm64 (Mac OSX ARM 64-bit)
ee2b2f457cb72c04f447283359b0e783  cmk.darwin.x86-64 (Mac OSX Intel-x86 64-bit)
6d711bbd5af2f2bce897f676c8dbe904  cmk.windows.x86-64.exe (Windows Intel-x86 64-bit)
90d28b42d7b7a5f502d5130506847ea7  cmk.windows.x86.exe (Windows Intel-x86 32-bit)

CloudMonkey v6.1.0

2020-07-29T05:46:42Z

v6.1.0 Release notes:

Fix issue of required parameters for tags and details
Fix issue of hostid parameter completing to show hosts with type=routing
Statically building the binary to not depend on gcc compiler #59
Allow http/https web-proxy support #49
Show keys as per provided filter for table/csv/column output #63
Don't sort header when filter keys are provided

Installation instruction for Linux/Mac OSX:

wget <file url>
chmod +x <cmk binary file>
mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.1.0 (build: abc3192, 2020-07-01T10:03:22+0530)

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

MD5 checksums:

3c6651f54b0047c6991c7887da750cd9  cmk.linux.x86-64 (Linux Intel-x86 64-bit)
93c1a094dbf7add90a0d7e45d3d1fa93  cmk.linux.x86 (Linux Intel-x86 32-bit)
e1b8badf7568942b56dd5714e937ec17  cmk.linux.arm64 (Linux ARM 64-bit)
eb2d6e506880b957710d18369abfc7ea  cmk.linux.arm32 (Linux ARM 32-bit)
8f21f276c4a331faffe08cb5b0b743c2  cmk.darwin.x86-64 (Mac OSX Intel-x86 64-bit)
0f8095296581734046014f13a46c15a3  cmk.windows.x86-64.exe (Windows Intel-x86 64-bit)
d2a8f2b9dfc89b2a8a8e29541d48c2bb  cmk.windows.x86.exe (Windows Intel-x86 32-bit)

CloudMonkey v6.0.0

2019-03-14T07:03:30Z

v6.0.0 Release notes:

Rewrite in Go, ships as single binary for Linux, Mac, and Windows
Drop-in replacement for legacy Python-based cloudmonkey
About 5-20x faster than legacy cloudmonkey
Interactive UX for parameter and arg completion and selection
JSON is the default output format
New column based output
Enable debug mode using set debug true option, file-based logging removed
Per server profile based API cache
New syntax arg=@/path/to/file to pass the content of file as API argument value similar to curl
Improve help docs using -h argument
Removed: XML output, coloured output, several set options

Additional notes:

cmk will create a new config directory under ~/.cmk, allowing legacy cloudmonkey to be used as well.
cmk will store server profile specific API cache in the ~/.cmk/profiles directory.

Installation instruction for Linux/Mac OSX:

wget <file url>
chmod +x <cmk binary file>
mv <cmk binary file> /bin/cmk

Docs: https://github.com/apache/cloudstack-cloudmonkey/wiki
Old docs: https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI

Usage:

usage: cmk [flags] [commands|apis] [-h]

CloudMonkey (cmk) 🐵 is a command line interface for Apache CloudStack.

Allowed flags:
  -h        Show this help message or API doc when specified after an API
  -v        Print version
  -o        API response output format: json, text, table, column, csv
  -p        Server profile
  -d        Enable debug mode

Default commands:
  exit      Exits
  help      Help
  set       Configures options for cmk
  sync      Discovers and updates APIs
  version   Version info

Version and build details:

Apache CloudStack 🐵 CloudMonkey 6.0.0 (build: 74ff37c, 2019-03-05T17:27:26+0530)

MD5 checksums:

e7ac29a9c5d54e65dbec7325a6f37637  cmk.linux.x86 (Linux Intel-x86 32-bit)
8d3288cfe33cb17aad4596d6b783f8b3  cmk.linux.x86-64 (Linux Intel-x86 64-bit)
b1bb34f3f96bccf44bcdd5f425e9017d  cmk.linux.arm32 (Linux ARM 32-bit)
a20f72642b5470e701d6b54a941d2196  cmk.linux.arm64 (Linux ARM 64-bit)
dfbf36b990c407095ee392e541b56329  cmk.darwin.x86-64 (Mac OSX Intel-x86 64-bit)
0ded9c5f8699c88918287adfdb7217f2  cmk.windows.x86-64.exe (Windows Intel-x86 64-bit)
3094e60ce6a28721ecc77655953e3fbf  cmk.windows.x86.exe (Windows Intel-x86 32-bit)

5.3.3

2016-11-03T04:27:17Z

Tagging release 5.3.3 on branch master.

5.3.2

2015-08-19T09:01:41Z

Tagging release 5.3.2 on branch master.

5.3.1

2015-02-26T10:39:35Z

Tagging release 5.3.1 on branch master.