# Komodo changelog
> A tool for building and deploying software across many servers.
- Vendor: Komodo
- Category: Developer Tools
- Official site: https://komo.do
- Tracked by: What's New (https://whatsnew.fyi/product/komodo)
- Harvested from: GitHub (moghtech/komodo)
- Entries below: 10 (newest first)
What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.
Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.
## Releases
### v2.3.1 — Komodo v2.3.1
- Date: 2026-07-31
- Version: v2.3.1
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.3.1
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.3.1
- **fixed** — Fix missing image registry accounts stored on database
- **changed** — Set komodo/$VERSION as connection user agent
- **fixed** — Fix UI export TOML not respecting selected tags in query
- **changed** — Further optimize query batching
#### Changelog
- Fix missing image registry accounts stored on database
- Set "komodo/$VERSION" as connection user agent.
- Fix UI export TOML not respecting selected tags in query
- Further optimize query batching
### v2.3.0 — Komodo v2.3.0
- Date: 2026-07-29
- Version: v2.3.0
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.3.0
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.3.0
- **added** — Add pagination for resource and container list APIs with default limit of 50 resources per page, supporting server-side sorting and improved term-based search
- **added** — Allow disabling pagination by passing limit: 0 in request body JSON for API users
- **added** — Break down memory usage into used and cache categories, supporting ZFS
- **added** — Support mid-build cancellation by terminating the running build command
- **added** — Support mid-run cancellation for Actions and Procedures
- **added** — Add top level stats viewer including multi-server charts
- **added** — Support batch executions matching by tags in Procedure with pattern matching using asterisk
- **added** — Allow server type builders to attach multiple servers with simultaneous builds distributed between them
- **added** — Support configuring custom name for container or swarm service in Deployment
- **added** — Allow viewing service list even when Stack is down, enabling deployment of single service without whole Stack
- **added** — Improve Google auth integration with id token validation
- **added** — Add omni-search clear on close option in UI
- **added** — Find Stack services from the omni-search
- **added** — Add shell escaping on ad-hoc commands and requests available to authenticated users with permission access below Write
- **added** — Add command-specific timeouts on shell commands
- **added** — Add opt-in reporting about Komodo usage
- **changed** — Build webhooks now cancel any running build before re-triggering for better handling of back-to-back git pushes
- **changed** — Actions cancel immediately by killing the deno process executing the script
- **changed** — Procedures cancel after the current parallel stage completes before moving onto the next stage
- **fixed** — Fix execute_terminal output capturing using sh
#### Changelog
Still running v1? Check out the [Komodo v2 upgrade guide](https://komo.do/docs/releases/v2.0.0#upgrading-to-komodo-v2).
##### Pagination
- Add pagination for resource and container list APIs, improved term based search and server-side sorting. Use Komodo with lots of resources without having issues due to over-querying.
- API users can still disable pagination by passing `limit: 0` in the request body json. The default limit is 50 resources per page.
- **UI / Containers**: Improved page responsiveness and container search with arbitrarily many containers using pagination.
##### RAM / Monitoring
- Break down memory usage into used / cache, supporting ZFS, by @ChanningHe.
##### Cancellation
- **Build**: All builds now support mid-build cancellation by terminating the running build command.
- Build webhooks now cancel any running build before re-triggering, better handling cases with back-to-back git pushes.
- **Action / Procedure**: Support mid-run cancellation.
- Actions cancel immediately by killing the deno process executing the script.
- Procedures cancel after the current parallel stage completes (before moving onto the next stage)
##### Stats page
- Top level stats viewer including multi-server charts
##### Misc.
- **Procedure**: Batch executions now support matching by tags.
- Specify a pattern of `*` to filter only by tags.
- **Builder**: Server type builders can now attach multiple servers and simultaneous builds will be distributed between them.
- **Deployment**: Support configuring custom name for container / swarm service
- The container / service name still defaults to deployment name
- **Stack**: Allow viewing service list even when down, enabling users to deploy single service without the whole Stack.
- **Auth**: Improve Google auth integration with id token validation by @MP-Tool
- **UI**: Add omni-search 'clear on close' option.
- **UI**: Find Stack services from the omni-search.
- **UI**: Fix permissions table performance.
- **Commands**: Add shell escaping on ad-hoc commands / requests available to authenticated users with permission access below Write.
- **Commands**: Add command-specific timeouts on shell commands. Fixes issues like #1392.
- **Reporting**: Add **opt-in** reporting about Komodo usage.
- **Action**: Fix `execute_terminal` output capturing using `sh` by @mvanhorn, fixing #1289
- **Build / Deployment**: Fix build -> deployment flow when build doesn't push semver tags.
- **Stack**: Fix compose config sanitization ordering by @mvanhorn and @mbecker20 re #868
- **Alerter / TOML**: Fix resource lists export resources IDs instead of names.
- **Git**: Fix giving clear log when `git` isn't installed, previously the message did not clearly identify the issue in logs.
- **UI**: Fix resource description responsive overflow.
- **UI / Websocket**: Send keepalive pings to help websocket maintain connection by @Dougley.
- **UI / Deployment**: Fix deployment tabs disappearing sometimes when in swarm mode.
### v2.2.0 — Komodo v2.2.0
- Date: 2026-05-07
- Version: v2.2.0
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.2.0
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.2.0
- **fixed** — Fix Deployment "Tasks" and "Inspect" tabs when attached to a Swarm
- **added** — Allow excluding specific services from Global Auto Update
- **changed** — During RunSync, ensure Repo changes are applied before all other potentially dependent resource type changes: Builds, Stacks, and Resource Syncs
- **added** — Add resource TOML schema for editor auto-complete, suggestions, and documentation hosted by every Komodo Core at /schema/resources.json
- **added** — Add standard shell mode (direct passthrough) for system commands
- **added** — Make the security headers customizable to restore iframe functionality with x_frame_options configuration
- **added** — Enable OIDC auto redirect behavior on login page with oidc_auto_redirect configuration
- **added** — Add per provider new user registration controls with disable_local_user_registration and disable_oidc_user_registration options
- **changed** — Improve table text sizing and wide log pre wrapping in UI
#### Changelog
- **Swarm / Deployment**: Fix Deployment "Tasks" and "Inspect" tabs when attached to a Swarm
- **Stack**: Allow excluding specific services from Global Auto Update by @mateuszziolkowski
- **Resource Sync**: During RunSync, ensure Repo changes are applied before all other potentially dependent resource type changes: Builds, Stacks, and Resource Syncs.
- **TOML**: Add resource TOML schema (for editor auto-complete / suggestions / documentation) hosted by every Komodo Core at `/schema/resources.json` (example: https://demo.komo.do/schema/resources.json) by @bytedream
- **Core**: Add standard shell mode (direct passthrough) for system commands by @ericls
- **Core**: Make the security headers customizable to restore iframe functionality
```toml
##### `X-Frame-Options` header value.
##### Set as empty string to omit the header.
##### Use "SAMEORIGIN" to allow same-origin embedding only.
##### Env: KOMODO_X_FRAME_OPTIONS
##### Default: "DENY"
x_frame_options = "DENY"
```
- **Core**: Enable OIDC auto redirect behavior on login page by @johnmaguire
```toml
##### Automatically redirect unauthenticated users to the OIDC provider
##### instead of showing the login page.
##### Users can bypass the redirect by appending `?disableAutoLogin` to the login URL.
##### Env: KOMODO_OIDC_AUTO_REDIRECT
##### Default: false
oidc_auto_redirect = false
```
- **Core**: Per provider new user registration by @johnmaguire
```toml
##### Normally new users will be registered, but not enabled until an Admin enables them.
##### With `disable_user_registration = true`, only the first user to log in will registered as a user.
##### Env: KOMODO_DISABLE_USER_REGISTRATION
##### Default: false
disable_user_registration = false
##### Disable local (username/password) user registration only.
##### When set to true, the "Sign Up" button is hidden and local signups are blocked,
##### but OIDC and other external provider signups may still be allowed.
##### If not set, falls back to `disable_user_registration`.
##### Env: KOMODO_DISABLE_LOCAL_USER_REGISTRATION
disable_local_user_registration = true
##### Disable OIDC user registration only.
##### When set to true, new users cannot register via OIDC,
##### but local and other provider signups may still be allowed.
##### If not set, falls back to `disable_user_registration`.
##### Env: KOMODO_DISABLE_OIDC_USER_REGISTRATION
#### disable_oidc_user_registration = true
```
- **UI**: Improve table text sizing and wide log pre wrapping by @elemated
- **UI**: Move more common components to **mogh_ui** library: https://github.com/moghtech/lib/tree/main/ui
Still running v1? Check out the [Komodo v2 upgrade guide](https://komo.do/docs/releases/v2.0.0#upgrading-to-komodo-v2).
### v2.1.2 — Komodo v2.1.2
- Date: 2026-04-10
- Version: v2.1.2
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.1.2
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.1.2
- **fixed** — Fix multiple compose file with identically named override services from causing UI crash when first created
#### Changelog
- **Stack**: Fix multiple compose file with identically named override services from causing UI crash when first created
Still running v1? Check out the [Komodo v2 upgrade guide](https://komo.do/docs/releases/v2.0.0#upgrading-to-komodo-v2).
### v2.1.1 — Komodo v2.1.1
- Date: 2026-04-02
- Version: v2.1.1
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.1.1
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.1.1
- **fixed** — Fix stack / deployment available updates not being picked up when attached to a Swarm
#### Changelog
- **Swarm**: Fix stack / deployment available updates not being picked up when attached to a Swarm
Still running v1? Check out the [Komodo v2 upgrade guide](https://komo.do/docs/releases/v2.0.0#upgrading-to-komodo-v2).
### v2.1.0 — Komodo v2.1.0
- Date: 2026-04-01
- Version: v2.1.0
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.1.0
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.1.0
- **added** — Add Update Node support to Swarm for updating node role (manager, worker), availability, and adding or removing node labels
- **added** — Add Swarm Stack environment file support by sourcing .env files on the shell before running docker stack deploy
- **added** — Enable Swarm Stacks and deployments to poll for updates and auto update
- **added** — Support disabling application-level logging timestamps
- **fixed** — Fix stack and service deploys hanging indefinitely if services never converge
- **fixed** — Fix resource sync support in Swarm
- **fixed** — Fix deepCompare method crash when encountering a null value, affecting some resource configuration pages
- **fixed** — Fix container ports not displaying when Server External Address is not configured
- **fixed** — Fix Build image registry Custom organization configuration
- **fixed** — Fix stack service and container selectors from crashing due to missing null check, affecting New Terminal creation menu
- **fixed** — Fix Info files Hide/Show buttons not working as clicking the header could toggle show
#### Changelog
- **Swarm**: Add "Update Node" support: update your swarm node `role` (manager, worker) and availability, and add / remove node labels
- **Swarm** / **Stack**: Add Swarm Stack environment file support.
- Docker swarm doesn't support files natively, this first **sources** the .env files on the shell, then runs `docker stack deploy`
- **Swarm**: Stacks and deployments attached to swarms can now poll for updates / auto update
- **Swarm**: Fix stack / service deploys hanging indefinitely if the services never converge
- **Swarm**: Fix resource sync support
- **UI**: Fix `deepCompare` method crash when encountering a `null` value, affecting some resource configuration pages.
- **UI**: Fix container ports not displaying when Server `External Address` not configured
- For users who used **privileged onboarding key** already, you can configure Server `External Address` to restore container port linking behavior.
- Future use of privileged onboarding key will move the existing Server `Address` to `External Address` field, if it's not already set.
- **UI**: Fix Build image registry Custom organization configuration.
- **UI**: Fix stack service / container selectors from crashing due to missing null check. This affected New Terminal creation menu.
- **UI**: Fix Info files "Hide / Show" buttons not working (clicking the header could still toggle show)
- **Logging**: Support disabling application-level logging timestamps
### v2.0.0 — Komodo v2.0.0
- Date: 2026-03-24
- Version: v2.0.0
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.0.0
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.0.0
- **added** — Docker Swarm support to manage swarm clusters, nodes, services, stacks, configs, and secrets
- **added** — Outbound periphery capability allowing Periphery to initiate the connection to Komodo Core
- **added** — PKI authentication with auto-generated key pairs and automatic rotation for Core and Periphery
- **added** — Onboarding keys for streamlined server onboarding with reusable keys
- **added** — Passkey and TOTP two-factor authentication for username and password login
- **added** — Multi-login Linking to allow users to link multiple login providers to their account
- **added** — Full OpenAPI documentation with interactive API docs
- **changed** — Terminals dashboard, km ssh, and Action scripting with improvements
- **changed** — UI with improved look, higher contrast, and better UI primitives
- **deprecated** — Passkeys in favor of PKI authentication
- **deprecated** — The :latest tag for Docker images, with v2 images only available with :2 tags
See the [**v2 upgrade guide.**](https://komo.do/docs/releases/v2.0.0#upgrading-to-komodo-v2)
##### Breaking
- 🚨 The v2 images are only available with `:2` tags. The `:latest` tag is now deprecated.
##### Changelog
- **Docker Swarm support**: Manage swarm clusters, nodes, services, stacks, configs, and secrets.
- **Outbound periphery**: Periphery can now initiate the connection to Komodo Core.
- **PKI authentication**: Core and Periphery now authenticate with auto-generated key pairs and automatic rotation. Passkeys are deprecated.
- **Onboarding keys**: streamlined server onboarding with reusable keys.
- **Improved terminals**: Terminals dashboard, `km ssh`, and improved Action scripting.
- **New UI**: Improved look with higher contrast and better UI primitives.
- **Passkey / TOTP 2FA**: Built in two factor authentication for username / password login.
- **Multi-login Linking**: Users can now link multiple login providers (Local, OIDC, Github, etc) to their account.
- **Full OpenAPI documentation**: Interactive API docs [now available](https://demo.komo.do/docs).
### v2.0.0-dev-124 — Komodo v2.0.0-dev-124
- Date: 2026-03-16
- Version: v2.0.0-dev-124
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.0.0-dev-124
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.0.0-dev-124
- Labels: Pre-release
- **changed** — Make sidebar more vertically compact
- **changed** — Make page tabs more compact with improved styling and better responsiveness
- **changed** — Improve the confirm changes modal with single click confirm and better sizing
- **changed** — Improve the multi-resource table Executions with icons and single click confirm
- **added** — Finish Repo and Procedure header info
- **fixed** — Fix Procedure UI Run Stack Service configuration modal not opening
- **fixed** — Fix miscellaneous styling issues in resource configuration UI
Core image: `ghcr.io/moghtech/komodo-core:2-dev`
Periphery image: `ghcr.io/moghtech/komodo-periphery:2-dev`
Km image: `ghcr.io/moghtech/komodo-cli:2-dev`
```
Systemd Periphery installer:
- Add `--version=v2.0.0-dev-124` to the install command.
- To go back to stable, run it again with `--version=v1.19.5`
```
- Sidebar more vertically compact
- Page tabs are more compact, have improved styling, and better responsiveness
- Improve the confirm changes modal with single click confirm, better sizing
- Improve the multi-resource table Executions with icons and single click confirm
- Finish Repo and Procedure header info
- Fix Procedure UI `Run Stack Service` configuration modal not opening
- Misc. styling fixes in resource configuration UI
- 🚨 There is a small change to a database schema that is made when you upgrade from v1 to v2. This is done automatically, but if you need to go back to v1, **before taking down the v2 Core container run**:
```sh
docker compose -p komodo exec core bash -c "km database v1-downgrade -y"
```
PR: https://github.com/moghtech/komodo/pull/889
### v2.0.0-dev-123 — Komodo v2.0.0-dev-123
- Date: 2026-03-05
- Version: v2.0.0-dev-123
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.0.0-dev-123
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.0.0-dev-123
- Labels: Pre-release
- **added** — Add debug logs for Core <-> Periphery connection auth
- **changed** — Improve OIDC support with better username extraction behavior
Core image: `ghcr.io/moghtech/komodo-core:2-dev`
Periphery image: `ghcr.io/moghtech/komodo-periphery:2-dev`
Km image: `ghcr.io/moghtech/komodo-cli:2-dev`
```
Systemd Periphery installer:
- Add `--version=v2.0.0-dev-123` to the install command.
- To go back to stable, run it again with `--version=v1.19.5`
```
- Adds debug logs for Core <-> Periphery connection auth
- Improve OIDC support with better username extraction behavior
- 🚨 There is a small change to a database schema that is made when you upgrade from v1 to v2. This is done automatically, but if you need to go back to v1, **before taking down the v2 Core container run**:
```sh
docker compose -p komodo exec core bash -c "km database v1-downgrade -y"
```
PR: https://github.com/moghtech/komodo/pull/889
### v2.0.0-dev-120 — Komodo v2.0.0-dev-120
- Date: 2026-02-26
- Version: v2.0.0-dev-120
- Original notes: https://github.com/moghtech/komodo/releases/tag/v2.0.0-dev-120
- Permalink: https://whatsnew.fyi/product/komodo/releases/v2.0.0-dev-120
- Labels: Pre-release
- **added** — New UI with higher contrast and better UI primitives
- **added** — Close button to Update and Alert details drawers
- **fixed** — Bug with changing configuration
- **fixed** — Batch execute button width in desktop view
Core image: `ghcr.io/moghtech/komodo-core:2-dev`
Periphery image: `ghcr.io/moghtech/komodo-periphery:2-dev`
Km image: `ghcr.io/moghtech/komodo-cli:2-dev`
Systemd Periphery installer:
- Add `--version=v2.0.0-dev-120` to the install command.
- To go back to stable, run it again with `--version=v1.19.5`
- **New UI** with higher contrast and better UI primitives
- Fixes bug with changing configuration
- Fixes batch execute button width in desktop view
- Adds close button to Update and Alert details drawers
- 🚨 There is a small change to a database schema that is made when you upgrade from v1 to v2. This is done automatically, but if you need to go back to v1, **before taking down the v2 Core container run**:
```sh
docker compose -p komodo exec core bash -c "km database v1-downgrade -y"
```
PR: https://github.com/moghtech/komodo/pull/889