Komodo Release Notes

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

See the v2 upgrade guide.

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.

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:

  docker compose -p komodo exec core bash -c "km database v1-downgrade -y"
  

• PR: #889

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:

docker compose -p komodo exec core bash -c "km database v1-downgrade -y"

PR: #889

Release notes

• 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:

  docker compose -p komodo exec core bash -c "km database v1-downgrade -y"
  

• PR: #889

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

New UI with higher contrast and better UI primitives

🚨 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:

docker compose -p komodo exec core bash -c "km database v1-downgrade -y"

PR: #889

Images

• 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

Fixes

Fixes incorrect "update available" when images on your host have multiple associated digests.

Upgrade notice

🚨 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:

docker compose -p komodo exec core bash -c "km database v1-downgrade -y"

PR: #889

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

Fixes incorrect "update available" when using images which hardcode a specific digest already (contain @ sign)

🚨 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:

docker compose -p komodo exec core bash -c "km database v1-downgrade -y"

PR: #889

Release notes

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

🚨 If you have issues logging in, clear browser cache and reload the page.

• OpenAPI documentation -- UI available at https://your.komodo.host/docs
• https://demo.komo.do/docs

Rework image update polling to use manifest call for latest digest without pulling image
Improve Swarm stack / service state inference re #1061
Add back komodo.execute_container_exec type methods for Action usage.
The only breaking change is you have to rename komodo.execute_terminal -> komodo.execute_server_terminal in your Actions
Improve resource configuration styling
Privileged mode onboarding keys to make reversing Periphery connection very simple
Komodo v2 upgrade guide preview: https://github.com/moghtech/komodo/blob/2.0.0/docsite/docs/setup/version-upgrades.md#updating-to-komodo-v2
🚨 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:

docker compose -p komodo exec core bash -c "km database v1-downgrade -y"

PR: #889