Release Notes

This page will be updated regularly. Check back often for the latest features, updates, and changes.

​

Latest Versions

• CLI
  • Date: September 12, 2025
  • Version Info
    • npm: 3.7.0
  • Installation Instructions

​

Known Issues

• CLI
  • Windows
    • Autocomplete functionality is not available. A workaround is available for cygwin.

​

CLI v3.7.0 Release

• Date: September 12, 2025
• Version Info
  • npm: 3.7.0
• Major Changes
  • A chart path is now required when running any of the following commands:
    • cpln helm template
    • cpln helm install
    • cpln helm upgrade
• 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
  • npm: 3.6.1
• Patch Changes
  • Fix resource not found during helm release migration to version 4.

​

CLI v3.6.0 Release

• Date: August 20, 2025
• Version Info
  • npm: 3.6.0
• 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
  • npm: 3.5.6
• 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
  • npm: 3.5.5
• Patch Changes
  • Fix issue where the cpln port-forward command session disconnects after 1 hour.

​

CLI v3.5.4 Release

• Date: June 5, 2025
• Version Info
  • npm: 3.5.4
• 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
  • npm: 3.5.3
• 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
  • npm: 3.5.2
• Patch Changes
  • Add —state-tag argument to cpln helm install & cpln helm upgrade.
  • Fix tags in helm release resources during cpln helm install & cpln helm upgrade.

​

CLI v3.5.1 Release

• Date: May 5, 2025
• Version Info
  • npm: 3.5.1
• Patch Changes
  • Hot fix for cpln image build command.

​

CLI v3.5.0 Release

• Date: May 5, 2025
• Version Info
  • npm: 3.5.0
• Minor Changes
  • Add YAML document separator for CRD list items.
  • Separate helm release deployments into individual secrets.
  • Prevent Helm release upgrades via cpln helm install; use cpln helm upgrade instead.
  • Add a limit to the release name length.
  • Add cpln helm get all subcommand.
  • Add cpln helm get notes subcommand.

​

CLI v3.4.5 Release

• Date: April 14, 2025
• Version Info
  • npm: 3.4.5
• 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
  • npm: 3.4.4
• 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
  • npm: 3.4.3
• Patch Changes
  • Update the cpln port-forward command to correctly handle refresh tokens.

​

CLI v3.4.2 Release

• Date: March 14, 2025
• Version Info
  • npm: 3.4.2
• 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
  • npm: 3.4.1
• Patch Changes
  • Improve cpln port-forward command.

​

CLI v3.4.0 Release

• Date: February 25, 2025
• Version Info
  • npm: 3.4.0
• Minor Changes
  • Add cpln port-forward command.

​

CLI v3.3.2 Release

• Date: February 17, 2025
• Version Info
  • npm: 3.3.2
• Patch Changes
  • Add --build option for stack commands.

​

CLI v3.3.1 Release

• Date: January 23, 2025
• Version Info
  • npm: 3.3.1
• 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
  • npm: 3.3.0
• 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
  • npm: 3.2.1
• 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
  • npm: 3.2.0
• Minor Changes
  • Add ‘names’ as a new output option.
  • Enhance cpln cp reliability and performance.
  • Add progress indicator for cpln cp.
  • Fix priority resource deletion order in cpln helm uninstall.
  • Add --all option to cpln helm get values.

​

CLI v3.1.1 Release

• Date: August 26, 2024
• Version Info
  • npm: 3.1.1
• 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
  • npm: 3.1.0
• 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:
  • Improve cpln convert command to convert ConfigMaps, Persistent Volume Claims and pull secrets.
  • Add --encoding option to cpln secret create-opaque command.
  • Fix path syntax for cpln mk8s kubeconfig command on Windows.
  • Use the first location of a GVC if the --location option is not specified for cpln workload exec, cpln workload connect and cpln cp commands. Specifying a location is no longer required.

​

CLI v3.0.0 Release

• Date: July 22, 2024
• Version Info
  • npm: 3.0.0
• Notes:
  • Fix cpln cp.
  • Allow identity name for policy binding.

​

CLI v2.4.0 Release

• Date: July 15, 2024
• Version Info
  • npm: 2.4.0
• 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
  • npm: 2.3.1
• Notes:
  • Fix stdin null issue on macOS.

​

CLI v2.3.0 Release

• Date: June 7, 2024
• Version Info
  • npm: 2.3.0
• 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
  • npm: 2.2.2
• 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
  • npm: 2.2.1
• Notes:
  • Add retry to internal API requests.
  • Helm: Skip resource deletion if specified.

​

CLI v2.2.0 Release

• Date: May 15, 2024
• Version Info
  • npm: 2.2.0
• Notes:
  • Additional k8s converter functionality.

​

CLI v2.1.0 Release

• Date: April 24, 2024
• Version Info
  • npm: 2.1.0
• 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
  • npm: 2.0.2
• 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
  • npm: 2.0.1
• 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
  • npm: 1.6.0
• 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
  • npm: 1.5.4
• 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
  • npm: 1.5.2
• 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
  • npm: 1.4.0
• 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
  • npm: 1.3.2
• 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
  • npm: 1.2.6
• 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
  • npm: 1.2.5
• 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