Skip to main content This page will be updated regularly. Check back often for the latest features, updates, and changes.
Latest Versions CLI v3.7.5 Release
Date: December 10, 2025
Version Info
Patch Changes
Enforce history limit post‑success and prune to configured depth in cpln helm command.
CLI v3.7.4 Release
Date: December 4, 2025
Version Info
Patch Changes
Update buildpacks builder to build using platform linux/amd64.
CLI v3.7.3 Release
Date: December 4, 2025
Version Info
Patch Changes
Update buildpacks to 0.39.0.
CLI v3.7.2 Release
Date: November 10, 2025
Version Info
Patch Changes
CLI v3.7.1 Release
Date: October 22, 2025
Version Info
Patch Changes
Update agent default image.
Read x-cpln stanza in docker-compose to override and extend workload spec.
Assume port protocol from port number in cpln convert command.
CLI v3.7.0 Release
Date: September 12, 2025
Version Info
Major Changes
A chart path is now required when running any of the following commands:
Minor Changes
Add --repo flag to install/upgrade helm charts from OCI registries or Helm repositories. Refer to the cpln helm guide for more info.
Add --install flag to cpln helm upgrade to automatically create and install a release with the given name if not present.
Patch Changes
Enforce validation so non-CPLN resources cause install or upgrade to fail.
Fix Helm notes rendering issue.
Update default image for cpln workload run command to ubuntu:latest.
Allow bare keys in .env to default to empty values in cpln stack command.
CLI v3.6.1 Release
Date: August 20, 2025
Version Info
Patch Changes
Fix resource not found during helm release migration to version 4.
CLI v3.6.0 Release
Date: August 20, 2025
Version Info
Minor Changes
Add --dependency-update to cpln helm commands.
Patch Changes
Fix typos and grammar mistakes.
Fix the displayed release name on error if user attempts to override a resource of a different release in cpln helm .
Fix cpln helm tag handling to persist only tags specified with —tag option and drop removed/unwanted ones.
Return a non-zero code if a backend error occurred in cpln workload exec or cpln workload connect commands.
Fix a cpln port-forward local server error for packaged binaries.
Fix K8s Converter Logging service 400 status on submit with refresh token.
Add public exposure detection to workload firewall in K8s K8s Converter .
Fix command array parsing to correctly assign extra items to args in K8s Converter .
Prevent subPath to be appended to mount path during K8s conversion .
CLI v3.5.6 Release
Date: July 11, 2025
Version Info
Patch Changes
Validate org name after parsing service account token during profile update.
Decode docker secret data if it is in base64 format.
Handle securityContext in K8s converter.
Decode dictionary secret values if the data is base64.
Fix helm list max limit being applied before processing revisions.
Show the helm release name not the secret name if the resource doesn’t belong to the release being installed.
Add cpln workload cron stop to be an alias of replica stop command.
CLI v3.5.5 Release
Date: June 6, 2025
Version Info
Patch Changes
CLI v3.5.4 Release
Date: June 5, 2025
Version Info
Patch Changes
Fix issue where the workload’s ready status was not displayed correctly when running the cpln workload get command.
CLI v3.5.3 Release
Date: May 23, 2025
Version Info
Patch Changes
Fix issue where Helm release was uninstalled on cpln helm upgrade when history limit was reached.
CLI v3.5.2 Release
Date: May 9, 2025
Version Info
Patch Changes
CLI v3.5.1 Release
Date: May 5, 2025
Version Info
Patch Changes
CLI v3.5.0 Release
Date: May 5, 2025
Version Info
Minor Changes
CLI v3.4.5 Release
Date: April 14, 2025
Version Info
Patch Changes
Add K8s CRD as an output option. (--output crd)
Fix agent default image.
Map health probe port to the number defined by the container port name in the cpln convert command.
Limit concurrent streams for the cpln cp command.
Measure upload/download speed instantaneously in the cpln cp command.
Allow rollback to deployed deployment in the cpln helm rollback command.
Remove unnecessary apostrophe at the end of the applied template link in the cpln helm command.
Avoid applying a resource with its GVC property in the cpln helm command.
Remove the requirement for the ‘type’ property within a K8s Secret in the cpln convert command.
Ensure unique names for PVCs defiend inside a StatefulSet workload in the cpln convert command.
CLI v3.4.4 Release
Date: March 28, 2025
Version Info
Patch Changes
Add cpln operator command.
Fix broken agent image issue affecting cpln agent up command.
Disable remote port validation in the cpln port-forward command.
Convert CPU and memory requests when no limits are specified in the Kubernetes converter.
Add CPLN_SKIP_UPDATE_CHECK environment variable to optionally bypass automatic update checks.
Fix typo for the defaulted location in the cpln connect / cpln exec commands.
Change cpln helm output to always display full links.
CLI v3.4.3 Release
Date: March 17, 2025
Version Info
Patch Changes
CLI v3.4.2 Release
Date: March 14, 2025
Version Info
Patch Changes
Submit a ticket to record a one-time audit trail entry for the cpln port-forward command.
Automatically connect to a different replica for each session when no specific replica is provided to the cpln port-forward command.
CLI v3.4.1 Release
Date: February 28, 2025
Version Info
Patch Changes
CLI v3.4.0 Release
Date: February 25, 2025
Version Info
Minor Changes
CLI v3.3.2 Release
Date: February 17, 2025
Version Info
Patch Changes
Add --build option for stack commands.
CLI v3.3.1 Release
Date: January 23, 2025
Version Info
Patch Changes
Convert user email characters to lowercase when inviting users.
Fix referencing existing secrets within workloads in Helm.
CLI v3.3.0 Release
Date: January 1, 2025
Version Info
Minor Changes
Add loadBalancer to cpln workload update command.
Add shared to volume set create command.
Add ipset command.
In cpln helm, avoid applying GVC related resources if GVC does not exist.
In cpln helm, avoid updating unchanged resources.
In cpln helm, introduce cpln/secret: tag when applying a Helm chart to update workloads that reference secrets.
Call the K8s converter logging service.
Print and highlight ignored properties of K8s objects when doing cpln convert with the --verbose option.
Disable nearest year rounding in table format.
CLI v3.2.1 Release
Date: December 2, 2024
Version Info
Patch Changes
Fix yaml output for cpln convert.
Handle tar errors and warnings.
Fix cpln cp for Windows.
Inject more cpln context to helm template.
Convert individual K8s Jobs.
CLI v3.2.0 Release
Date: November 1, 2024
Version Info
Minor Changes
CLI v3.1.1 Release
Date: August 26, 2024
Version Info
Patch Changes:
Fix a bug causing invalid target links in policies when converting K8s files using the cpln convert .
Add tags that are passed to cpln helm install to the state as well.
CLI v3.1.0 Release
Date: August 19, 2024
Version Info
Major Changes:
Refactor of cpln workload exec command:The cpln workload exec command has been updated to align with the functionality of kubectl exec .For more details, refer to the cpln workload exec guide .
Stdin and TTY Handling: Previously, stdin and TTY were enabled by default. Now, these must be explicitly set:
Use the -i option to send stdin to the workload.
Use the -t option to treat stdin as TTY.
Minor Changes:
CLI v3.0.0 Release
Date: July 22, 2024
Version Info
Notes:
Fix cpln cp.
Allow identity name for policy binding.
CLI v2.4.0 Release
Date: July 15, 2024
Version Info
Notes:
Use cpln://reference to reference fieldRef for K8s Converter.
Add BYOK location support.
Allow setting profile’s default org and gvc to empty.
Optimize the performance of the cpln helm list command.
Add cpln cp command.
Directly stream stdin to the workload replica when using the cpln workload exec and cpln workload run commands.
CLI v2.3.1 Release
Date: June 9, 2024
Version Info
Notes:
Fix stdin null issue on macOS.
CLI v2.3.0 Release
Date: June 7, 2024
Version Info
Notes:
Query by GVC if —gvc option is specified.
Fix stack capture of command & args.
Retry requests upon hitting rate limits.
Remove maxContentLength limit.
Handle standard input (stdin) in workload exec.
Enhance error handling for Helm deployment API call failures.
Add —no-cache argument to image build command.
CLI v2.2.2 Release
Date: May 28, 2024
Version Info
Notes:
Notify users of a new CLI version once a day.
Prevent a helm release from managing a resource that belongs to a different release.
CLI v2.2.1 Release
Date: May 15, 2024
Version Info
Notes:
Add retry to internal API requests.
Helm: Skip resource deletion if specified.
CLI v2.2.0 Release
Date: May 15, 2024
Version Info
Notes:
Additional k8s converter functionality.
CLI v2.1.0 Release
Date: April 24, 2024
Version Info
Notes:
Truncate description text if length > 40 characters.
Add alias and update location table view for mk8s.
CLI v2.0.2 Release
Date: April 1, 2024
Version Info
Notes:
Fix terminal interrupt handlers.
Provide user with a manual delete command to delete workload if workload run fails.
Fix generate name bug in helm.
Modify priority order in order for policy to be created before workload.
CLI v2.0.1 Release
Date: March 18, 2024
Version Info
Notes:
Add CRON get command.
Add fetch pages to CRON get and snapshot get.
Limit cron get and snapshot get output to —max.
Add release notes page to readme.
Add delete and get volume commands.
Enforce valid naming in stack command.
Require location for workload connect/exec command.
Add resize terminal feature to workload run interactive.
Fix protocol override in k8s converter.
Add stop replica command.
Add helm rollback and helm history.
Add helm upgrade command.
Remove clone command from volumeset.
Upgrade default buildpacks to builder:22.
CLI v1.6.0 Release
Date: February 7, 2024
Version Info
Notes:
Print workload cron start command output as a table.
Add container override arguments to the workload cron start command.
Fix file option to load from stdin when file option is optional.
Update description for: clone, Expand volume set, snapshot.
Fix command snapshot date formats.
For snapshot, Update column name from Created to Snapshot Created.
Logs: add -f as alias to -t.
Fix delete in workload run command.
Add external id to AWS and ECR secrets.
Update dependencies.
CLI v1.5.4 Release
Date: January 23, 2024
Version Info
Notes:
Add ACTIVE column for profiles.
Modify helm list to display release names only.
Print NOTES.txt on helm install.
Sort helm template output before applying.
Add helm wait option.
Helm —wait option to wait 5m if —timeout is not provided.
Fix for terminal resizing.
Inject GVC into the helm template command as a value.
Add volume set and snapshot commands.
Add cron and replica sub-commands to workload.
CLI v1.5.2 Release
Date: December 6, 2023
Version Info
Notes:
Fix workload connect prompt length and line wraps.
Improve workload connect prompt issue.
Resizing terminal on the initial connection.
Change login port to 48794.
Add check for latest release.
Add stack command.
Add helm command.
Add —replace flag.
CLI v1.4.0 Release
Date: November 21, 2023
Version Info
Notes:
Fix prompt length and line wrap when connecting to workload + Improve volumeset deletion.
Force delete command.
Fix SAML login.
Add tags enabled for the workload run command.
CLI v1.3.2 Release
Date: October 30, 2023
Version Info
Notes:
Remove deploy timestamp tag from slimmed objects.
Add account get and org create.
Add token server.
CLI v1.2.6 Release
Date: October 16, 2023
Version Info
Notes:
Remove deploy timestamp tag from slimmed output.
Connect to first replica if multiple are present.
Add ready flag to apply command.
Add remove tag flag.
Adding useful error messages to auto-completion installation.
CLI v1.2.5 Release
Date: September 28, 2023
Version Info
Notes:
Fix bug in setting sleep for ubuntu image on run cmd.
Deprecate container port property. Use ports going forward.
Inform user on verbose mode when CPLN_ORG, CPLN_GVC, CPLN_ENDPOINT or CPLN_PROFILE is being used.
Add mk8s command.
Fix GVC add/remove location commands when resource doesn’t contain a location property.
Improved slim output format.
Add recursive folder support for apply command.
Add Terraform output option.
Add retry logic to the workload run command.
CLI v1.1.0 Release
Date: July 9, 2023
Version Info
npm: 1.1.0 / Build: 925739349 / Version: 9784f19
Notes:
Added json-slim and yaml-slim output options.
CLI v1.0.0 Release
Date: June 27, 2023
Version Info
npm: 1.0.0 / Build: 912602973 / Version: bddd583
Notes:
Logs: maxBodySize not set when reading.
Inform user when the environment variable CPLN_TOKEN is being used for authentication.
Updates to cpln workload run command.
CLI v0.0.90 Release
Date: May 5, 2023
Version Info
npm: 0.0.90 / Build: 859056052 / Version: b58459f
Notes:
Update HTML on cpln login browser page.
CLI v0.0.82-89 Release
Date: April 21, 2023
Version Info
npm: 0.0.89 / Build: 844733757 / Version: ba7245d
Notes:
Fix get all workloads from all GVCs.
Update image copy command to use a destination profile.
Workload run command.
Allow --tag to accept an optional value.
CLI v0.0.82 Release
Date: March 15, 2023
Version Info
npm: 0.0.82 / Build: 807750891 / Version: 99792cd
Notes:
Added image copy command.
CLI v0.0.73-81 Release
Notes:
K8s converter not creating identity and policy if not required.
Added prestop hook for k8s converter.
Added GVC environment variables and container inherit environment variables.
Added active deadline seconds to workload update command.
Fixed token for fetching logs, exec, and connect.
Fixed long websocket connections.
Added SAML login.
Fix workload create for standard workload type.
Added workload ready status to workload get command.
Command: Only enable raw mode if it’s TTY.
CLI v0.0.72 Release
Date: November 7, 2022
Version Info
npm: 0.0.72 / Build: 687290579 / Version: 718968f
Notes:
Added docker store and erase commands. Fixes issue when using both cpln image and docker login commands.
CLI v0.0.71 Release
Date: November 2, 2022
Version Info
npm: 0.0.71 / Build: 683695375 / Version: 3124c60
Notes:
Added instructions to create an Azure Connector Cloud Account.
Added delete resource from files command cpln delete.
Added k8s manifest to Control Plane manifest converter command cpln convert.
Added stop/start/suspend commands to cpln workload.
Added cpln workload exec command.
Installation Instructions
CLI v0.0.61 Release
Date: August 30, 2022
Version Info
npm: 0.0.61 / Build: 626945486 / Version: 2f98cdd
Notes:
Updated agent image version.
Added standard workload.
CLI v0.0.60 Release
Date: August 24, 2022
Version Info
npm: 0.0.60 / Build: 621247366 / Version: cd5c35e
Notes:
Updated agent image version.
CLI v0.0.59 Release
Date: July 28, 2022
Version Info
npm: 0.0.59 / Build: 599431645 / Version: 4ebdf36
Notes:
Added NGS Cloud Account.
Added NATS Account Secret type.
Removed GVC domain.
Upgrade buildpacks to version 0.27.0.
CLI v0.0.57 Release
Date: May 23, 2022
Version Info
npm: 0.0.57 / Build: 545699003 / Version: e16bbbf
Notes:
Add default of 50 maximum records.
Fix issue when using a value < 1 to return all records.
Fix issue when updating container memory.
Add additional set flags for the workload update command.
CLI v0.0.55 Release
Date: February 21, 2022
Version Info
npm: 0.0.55 / Build: 475892711 / Version: 6b87320
Notes:
Add —psp flag for agent manifest command to configure a pod security policy.
Enable the k8s agent to run as a privileged pod.
Previous Versions CLI v0.0.54 Release
Date: February 10, 2022
Version Info
npm: 0.0.54 / Build: 467951861 / Version: 7c17ca8
Notes:
Fix issues with the k8s Agent.
Fix issue when building images on ARM64 machines.
CLI v0.0.52 Release
Date: January 20, 2022
Version Info
npm: 0.0.52 / Build: 452736596 / Version: bffc420
Notes:
Updated login page.
Fix issue persisting profile default GVC when using the —token flag.
CLI v0.0.50 Release
Date: December 28, 2021
Version Info
npm: 0.0.50 / Build: 438151551 / Version: f1586e9
Notes:
Update pack to version 0.23.0.
Added ARM64 support for pack.
CLI v0.0.49 Release
Date: November 30, 2021
Version Info
npm: 0.0.49 / Build: 419000724 / Version: cdc6af5
Notes:
Fix issue building an image using an ARM processor.
CLI v0.0.48 Release
Date: November 18, 2021
Version Info
npm: 0.0.48 / Build: 411017996 / Version: d1b67a5
Notes:
Updated k8s agent version.
CLI v0.0.47 Release
Date: November 11, 2021
Version Info
npm: 0.0.47 / Build: 407265118 / Version: 140e31f
Notes:
Added cpln agent manifest command to allow running an agent on a k8s cluster.
CLI v0.0.46 Release
Date: October 11, 2021
Version Info
npm: 0.0.46 / Build: 386067508 / Version: 7ca3dd7
Notes:
Update error handling:
All errors are outputted to stderr.
If the -o flag is set to json or yaml, the output will be in the respective format. If -o is set to text, only the
output of the .message property from response object will be outputted. Otherwise, output the
error.message property from the exception.
If there are multiple actions, any errors will be included in the output.
The exit code will be 1 if at least one action failed.
Added force-redeployment subcommand to the workload command.
CLI v0.0.44 Release
Date: September 10, 2021
Version Info
npm: 0.0.44 / Build: 368794552 / Version: 6435502
Notes:
New workload subcommands:
connect: Connect to a replica of the workload.
get-replicas: Get the replicas of the referenced workload in a given location.
CLI v0.0.43 Release
Date: September 7, 2021
Version Info
npm: 0.0.43 / Build: 365437960 / Version: f3f59d1
Notes:
New secret type: azure-connector
CLI v0.0.42 Release
Date: July 16, 2021
Version Info
npm: 0.0.42 / Build: 338229644 / Version: db33b86
Notes:
CLI can work without CPLN_ENDPOINT
Allow environment variables without a value
Add mount volumes to workload
CLI v0.0.41 Release
Date: July 14, 2021
Version Info
npm: 0.0.41 / Build: 336244315 / Version: b864944
Notes:
Create ~/.docker during cpln image docker-login
CLI v0.0.40 Release
Date: June 30, 2021
Version Info
npm: 0.0.40 / Build: 329714271 / Version: 4c67950
Notes:
Infers container name from image name unless defined using the —container-name argument.
Set internal firewall to same-org when the --public flag is used during the creation of a workload.
CLI v0.0.39 Release
Date: June 22, 2021
Version Info
npm: 0.0.39 / Build: 325071193 / Version: acbc925
Notes:
Added ‘smart’ reveal to secret output format
Added multi-document sources for the apply command
CLI v0.0.38 Release
Date: June 16, 2021
Version Info
npm: 0.0.38 / Build: 321518748 / Version: aa315ea
Notes:
Remove account subcommand and references
Update buildpacks to version 0.19.0
Add create-ecr secret command
Fix create command for Cloud Account to include additional error messages
Fix issue when shell would close when running cpln login
CLI v0.0.36 Release
Date: June 7, 2021
Version Info
npm: 0.0.36 / Build: 315420524 / Version: cb4cb4f
Notes:
For the binary package, include the executable docker-credential-cpln in the same archive as the CLI
CLI v0.0.34 Release
Date: May 31, 2021
Version Info
npm: 0.0.34 / Build: 312124373 / Version: 0a44b37
Notes:
Make profile optional if at least —endpoint & —token flags are set
When there is a profile present, honor the environment variables ‘CPLN_ORG’, ‘CPLN_GVC’, ‘CPLN_ENDPOINT’, and ‘CPLN_TOKEN’
Install auto-completion for non-interactive installation
CLI v0.0.33 Release
Date: May 6, 2021
Version Info
npm: 0.0.33 / Build: 298694423 / Version: 30dc6d4
Notes:
Added task as a policy target kind
Resume cpln logs stream on disconnect
Refresh authentication token before getting logs
Fix for missing Docker config.json file
CLI v0.0.31 Release
Date: May 1, 2021
Version Info
npm: 0.0.31 / Build: 295632825 / Version: 01e4461
Notes:
Added cpln agent info command
CLI v0.0.30 Release
Date: April 27, 2021
Version Info
npm: 0.0.30 / Build: 293303600 / Version: 81bde51
Notes:
Fix for the closing of a command or PowerShell shell in Windows 10 if the cpln login command is executed.
Updated axios to version 0.21.1
