CHANGES.md

v5.11.0 (unreleased)

v5.10.0 (2026-03-10)

• Add --auth flag to koyeb service create, koyeb service update, and koyeb deploy to add security policies (basic auth or API key) to all routes. Supports referencing secrets with {{secret.SECRET_NAME}} syntax. Use --auth-disable to remove all security policies.

v5.9.1 (2026-01-19)

• Add koyeb sandbox subcommand for managing interactive sandbox environments. Sandboxes are created with koyeb service create --type=sandbox and support running commands, managing processes, filesystem operations, and port exposure.
• Add koyeb service scale commands (get, update, delete) for manual scaling of services, with support for per-region scaling using --scale region:instances format.
• Add --light-sleep-delay and --deep-sleep-delay flags to koyeb service create, koyeb service update, and koyeb deploy to configure how long an idle service waits before entering light sleep or deep sleep mode. Set to 0 to disable. Only available when --min-scale is 0.

v5.9.0 (2026-01-05)

• Add lifecycle management flags to automatically delete apps and services:
  • --delete-when-empty for koyeb app create and koyeb app update - Automatically delete the app after the last service is deleted. Empty apps created without services are not deleted.
  • --delete-after-delay for koyeb service create, koyeb service update, and koyeb deploy - Automatically delete the service after a specified duration from creation (e.g., --delete-after-delay 24h).
  • --delete-after-inactivity-delay for koyeb service create, koyeb service update, and koyeb deploy - Automatically delete the service after being inactive (sleeping) for a specified duration (e.g., --delete-after-inactivity-delay 1h).

v5.8.0 (2025-12-30)

• Update the API version to include the new SANDBOX type
• Add --proxy-port to support the TCP proxy functionality

v5.7.0 (2025-07-18)

• Add --wait and --wait-timeout to app init, service create, service update, service redeploy and deploy.
  • By default the --wait-timeout duration will be 5 minutes, but can be changed by using like this: --wait-timeout 1m

v5.6.0 (2025-07-17)

• Add koyeb compose which is docker compose like functionality.

• Changed the detailed view for the databases list and get subcommand, to display the compute time instead of the active time.

v5.5.1 (2025-05-27)

• Fix support for private registry secret update

v5.5.0 (2025-03-17)

• Support new log experience
  • Query logs time ranges with --start-time and --end-time
  • Query logs with text and regex filters
  • Deprecating --since in logs commands replacing it with --tail
  • #279

v5.4.3 (2025-03-07)

• Fix default min-count for free instances
  • #275

v5.4.2 (2025-03-03)

• Add --ignore-dir flag to koyeb archive create command and --archive-ignore-dir flag to koyeb deploy command to allow overwriting the directories ignored by default.
  • #274

v5.4.1 (2025-02-26)

• Fix koyeb app update <app> --domain <newname> which was hitting an API error.
  • #272

v5.4.0 (2025-01-20)

• Add the --config-file flag to the service create and update commands, to add/remove config files to a service.
  • #266

v5.3.2 (2024-12-23)

• Fix exit status on logs when it's a client timeout.

v5.3.1 (2024-11-27)

• Fix release.

v5.3.0 (2024-11-07)

• koyeb service unapplied-changes <service_id>: display "no changes" when there is no stashed deployment, or when the stashed deployment is the same as the current deployment.
  • #259
• koyeb service update: fix when changing the type of an environment variable given with --type
  • #260

v5.2.0 (2024-10-24)

• Add the snapshots subcommand to manage volume snapshots.
  • https://github.com/koyeb/koyeb-cli/pull/250/files
  • #256
• Add the --snapshot flag to the volume creation command, to create a volume from a snapshot.
  • https://github.com/koyeb/koyeb-cli/pull/254/files
  • https://github.com/koyeb/koyeb-cli/pull/255/files
• Add command koyeb service unapplied-changes <service_id> to view the changes that have been made with koyeb service update --save-only.
  • #258

v5.1.0 (2024-09-26)

• Add --deployment-strategy which can have the value rolling, blue-green or immediate to service.
  • https://github.com/koyeb/koyeb-cli/pull/248/files
• Fix the logic on how validation is performed for --port to avoid raising an error when TCP ports are used and --routes are not set.

v5.0.0 (2024-08-20)

• Breaking change: the application name needs to be provided with koyeb db commands. In the past, the command koyeb db create mydb created a database named mydb under the hardcoded application koyeb-db-preview-app. With this new version, it is mandatory to specify the service name, for example with koyeb db create myapp/mydb or koyeb db create mydb --app myapp.
• Allow to rename a database with koyeb db update myapp/mydb --name newname.

v4.3.0 (2024-07-31)

• Change the volumes subcommand to handle sizes in GB.
• Add --checks-grace-period to set the grace period for health checks, for example with koyeb service update app/service --checks 8000:http:/healtcheck --checks-grace-period 8000=10.
• Add --since to koyeb service logs, koyeb deployment logs and koyeb instance logs.
• Reconnect logs when the websocket is closed.

v4.2.0

• Add volumes subcommand.
• Allow to edit service volumes with koyeb service update --volume.
• Better error message when performing actions requiring a user context with an organization token.
  • #235

v4.1.1 (2024-06-06)

• Fix release.

v4.1.0 (2024-06-06)

• Add --autoscaling-concurrent-requests and --autoscaling-requests-response-time to koyeb service create and koyeb service update.

v4.0.0 (2024-05-22)

• Fix nil dereference in koyeb deployment logs -t build.
• Create new command koyeb archives create <path> to store an archive. This command will be necessary for the future deployment of a directory.
• Add --archive parameters to koyeb service create and koyeb service update to deploy an archive instead of a Docker image. The archive is stored in GCS and can be created with koyeb archives create.
• Add command koyeb deploy <directory> <app_name>/<service_name>.
• Allow to specify --git-sha in koyeb service update and koyeb service create. Warning: if the service is deployed with a specific git sha (which is the case if the deployment has been triggered by the "git push" webhook), koyeb service update without --git-sha will no longer deploy the latest commit, but the commit set in the configuration. To deploy the latest commit, use koyeb service update --git-sha ''.
  • #222

v3.12.0 (2024-05-07)

• Add koyeb service update <app>/<service> --name <new_name> to rename a service
  • #211
• Fix when changing the source of a project from Docker to Git.
  • #215
• Add koyeb apps update --domain <subdomain> <app> to change the autoassigned subdomain

v3.11.0 (2024-04-15)

• Add warning when accessing logs of a deployment with skipped build.
  • #201
• Add instance ID to koyeb service logs, koyeb deployment logs and koyeb instance logs
  • #202
• Add the --save-only flag to the koyeb services update command, that only saves the changes and does not trigger an immediate deploy.
  • #200
• Support -o json for koyeb service logs, koyeb deployment logs and koyeb instance logs
  • #203
• Add command koyeb metrics get to get the metrics of a service or an instance
  • #162
• It is now possible to create services only available from the mesh, for example with koyeb service create app/service --docker nginx --port 80:tcp. With only --port 80 (equivalent to --port 80:http), the service is also exposed to the internet.
  • #207

v3.10.0 (2024-03-28)

• Add the --skip-build flag for the koyeb services redeploy and koyeb services update commands.
• Add --app and --service flags to koyeb deployments list to filter deployments by app and service.
  • #197
• Add --deployment to koyeb regional-deployments list to filter regional deployments by deployment ID.
  • #198

v3.9.0 (2024-03-14)

• Display date in koyeb service logs and koyeb instance logs
  • #190
• Display the log stream in koyeb service logs and koyeb instance logs
  • #192

v3.8.1

• Better help message for koyeb cp
• The version 3.8.0 had never been released because the github action has not been triggered. This version is a re-release of the version 3.8.0.

v3.8.0

• koyeb service update: remove autoscaling targets when --min-scale is equal to --max-scale
  • #182
• koyeb deployment get and koyeb deployment describe now display the GIT commit hash for git services types
  • #184
• Check the validity of the docker image when creating or updating a service
  • #185

v3.7.1

• Add koyeb db update <name> --instance-type <type> to update the instance type of a database
  • #180

v3.7.0

• Add koyeb regional-deployments list and koyeb regional-deployments get. Also works with the aliases rd, rdeployment and rdeployments.
  • #176
• Stop hardcoding the maximum usage time and the database size displayed by koyeb db list and koyeb db get
  • #169

v3.6.1

• Always fetch the latest git commit with koyeb service update. It should fix the issue where an old commit is deployed instead of the latest one.
  • #175

v3.6.0

• koyeb service create and koyeb service update accept the parameters --autoscaling-average-cpu, --autoscaling-average-mem and --autoscaling-requests-per-second to set the autoscaling policy.
  • #170
• Add the option --skip-cache to koyeb service update
  • #172

v3.5.2

• Fix koyeb service update --git-build-command and koyeb service update --git-run-command when the service has already a build command or a run command configured.
  • #168

v3.5.1

• Fix build. See v3.5.0 for the other changes.

v3.5.0

• Fix nil pointer dereference when --url is invalid
  • #155
• Fix error when the token is invalid and the user tries to switch organization
  • #154
• Stop rendering partial connection string during the provisioning of a database
  • #159
• Allow to manage registry secrets with koyeb service create --type registry-<type> and koyeb service update
  • #157
• Add koyeb instance cp to copy files from and to an instance, for example with koyeb instance cp file.txt <instance_id>:/tmp/ or koyeb instance cp <instance_id>:/tmp/file.txt .
  • #161

This version has never been released and is replaced with v3.5.1.

v3.4.0

• Accept the two syntaxes --app xxx and <app>/<service_name> for koyeb service commands
  • #121
• Update the user agent from 'OpenAPI-Generator/1.0.0/go' to 'koyeb-cli/version'
  • #149
• The new flag --override of koyeb service update allows to override the service configuration instead of merging the other options provided with the existing configuration.
  • #147
• Support koyeb secret reveal <secret_name> (or koyeb secret show <secret_name>). The API behind this command is not stable yet and may change in the future. This command can break at any time and will require an update of the CLI.
  • #150
• Fix an issue where running koyeb organizations switch without specifying an organization or specifying more than one organization would crash.
  • #151
• The default --port and --route for koyeb service create is now the port 8000 to match the default of https://app.koyeb.com
  • #152
• koyeb service create: set default branch to main
  • #153
• Implement koyeb database list, koyeb database create, koyeb database get and koyeb database delete
  • #144

v3.3.2

• Dynamically set --port and --route. Now, koyeb service create xxx --app yyy --port 8000 automatically creates the route /:8000. Similarly, koyeb service create xxx --app yyy --route /:9999 automatically creates the port 9999:http. If --port and --route are both omitted, as before, the default port 80:http and route /:80 are created.
  • #101

v3.3.1

• Fix a bug where koyeb services exec / koyeb instances exec would not work for users being members of multiple organizations
  • #146

v3.3.0

• Add the flag --privileged to koyeb service create and koyeb service update
  • #137

v3.2.0

• The option --min-scale and --max-scale of koyeb service update where ignored, and the service was always scaled to 1. This is now fixed. Also, add the option --scale which sets both --min-scale and --max-scale to the same value. If --min-scale or --max-scale is set, it overrides --scale.
  • #122
  • #124
• Add completion for fish shell, thanks to @razvanazamfirei
  • #118
• The option --git-builder of koyeb service update was ignored when we wanted to update the git builder. This is now fixed.
  • #119
• Add support for organizations. Use command koyeb organization list to list the organizations you are a member of, and koyeb organization use to switch to another organization.
  • #113
• Fix koyeb service logs when using the non-default organization
  • #120
• Fix --regions options of koyeb service create and koyeb service update. To deploy an existing service to a new region, use koyeb service update <app>/<service> --region <region>. To remove a region from a service, use koyeb service update <app>/<service> --region '!<region>'. On service creation, the service is still deployed to fra if no region is specified. If more than two regions are specified, a warning message is displayed to avoid billing surprises.
  • #123

Prior v3.2.0

Unfortunately, we didn't keep a changelog before v3.0.2. We will try to do better in the future.