Release Notes
This page provides information about updated third-party components and configuration changes available in new CodeMie releases.
CodeMie 2.35.0
Release Date: June 22, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
security.processAuthSecretremoved from AI/Run CodeMie Backend Helm chart — the static shared-secret approach for inter-process authentication (INTERNAL_BIND_KEY) has been replaced with per-request HMAC signing. The key is now generated in-memory at pod startup and no Kubernetes Secret is needed.Configuration housekeepingIf the AI/Run CodeMie Backend Helm chart values still contain
security.processAuthSecret, it can be safely removed:# Remove the following block from your custom Helm values:
security:
processAuthSecret:
create: false
name: "internal-bind-key"
field: "bind-key"If you created a Kubernetes Secret for
INTERNAL_BIND_KEYmanually (e.g. for ArgoRollout deployments), it can also be safely deleted. -
MCP Connect Service isolated to a dedicated Kubernetes namespace —
codemie-mcp-connect-serviceis now deployed in its owncodemie-mcp-connect-servicenamespace with Pod Security Admission (restricted) enforced. This improves workload isolation and aligns with security best practices.Script deploymentsThe provided deployment script handles namespace creation, Pod Security Admission labeling, and service deployment automatically. No manual action is required.
Manual migration (without deployment script)To apply the same isolation manually:
-
Create the namespace and apply Pod Security Admission labels:
kubectl create namespace codemie-mcp-connect-service
kubectl label namespace codemie-mcp-connect-service \
pod-security.kubernetes.io/enforce=restricted \
pod-security.kubernetes.io/enforce-version=latest \
--overwrite -
Redeploy the Helm chart into the new namespace and update
MCP_CONNECT_URLin the AI/Run CodeMie Backend Helm values:- name: MCP_CONNECT_URL
value: "http://codemie-mcp-connect-service-{MCP_CONNECT_BUCKET}.codemie-mcp-connect-service-headless.codemie-mcp-connect-service:3000" -
Delete the old deployment from the
codemienamespace.
-
CodeMie 2.34.0
Release Date: June 15, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
External Secrets Operator IRSA provisioning removed from AWS Terraform code.
-
SSH key pair module and its usage in the EKS cluster configuration removed from AWS Terraform code.
-
Fluent-bit version upgrade from 4.2.3.1 to 5.0.7.
CodeMie 2.33.0
Release Date: June 9, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.32.0
Release Date: June 4, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
AWS EKS authentication via ConfigMap no longer supported and removed from terraform scripts.
-
Added optional provisioning AWS Valkey (Redis Cache).
Redis usageRedis instance is required to enable functionality such as WebHook rate limiter.
CodeMie 2.31.0
Release Date: June 1, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.30.0
Release Date: May 27, 2026 · GitHub Tag ↗
Third-Party Component Updates
Keycloak Operator 1.34.0
keycloak-operator has been updated from 1.32.0 to 1.34.0 (Helm chart 1.32.0 to 1.34.0). For details, see the keycloak-operator 1.34.0 Release Notes ↗.
Configuration Changes
-
opsPoolremoved from AI/Run CodeMie Backend Helm chart - this workload was deprecated and is no longer supported. Remove allopsPool.*fields from the custom Helm values before upgrading.Configuration housekeepingIf the AI/Run CodeMie Backend Helm chart values still contain
opsPool, it can be safely removed.
Hotfixes
- 2.30.1 · GitHub Tag ↗ – May 29, 2026
CodeMie 2.29.0
Release Date: May 22, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
[BREAKING] Ingress annotations removed from upstream Helm charts
Breaking ChangeThese annotations are no longer shipped as defaults in the Helm charts but are still required for oauth2-proxy authentication to work. Add them to the custom Helm values before upgrading to preserve this behavior.
The following oauth2-proxy ingress annotations announced for removal in 2.28.0 have been removed from the default values of the AI/Run CodeMie Backend and AI/Run CodeMie UI Helm charts:
nginx.ingress.kubernetes.io/auth-response-headers: X-Auth-Request-Access-Token,Authorization
nginx.ingress.kubernetes.io/auth-signin: https://$host/oauth2/start?rd=$escaped_request_uri
nginx.ingress.kubernetes.io/auth-url: http://oauth2-proxy.oauth2-proxy.svc.cluster.local:80/oauth2/auth
Hotfixes
- 2.29.1 · GitHub Tag ↗ – May 25, 2026
CodeMie 2.28.0
Release Date: May 21, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
viteEnableAnalyticsremoved from AI/Run CodeMie UI Helm chart — this value and the correspondingVITE_ENABLE_ANALYTICSenvironment variable were deprecated and are no longer supported.Configuration housekeepingIf the
AI/Run CodeMie UIHelm chart values still containviteEnableAnalytics, it can be safely removed. -
Infrastructure logs index renamed — the default value of
ELASTIC_LOGS_INDEXchanged fromcodemie_infra_logs*tologs-codemie-infra*. If this value is set explicitly in the deployment, update it accordingly. See Logs Retention for cleanup and retention configuration. -
Upcoming change: ingress annotations — the following oauth2-proxy ingress annotations will be removed from the AI/Run CodeMie Backend and AI/Run CodeMie UI Helm charts in a future release:
Removed from default Helm chart values in 2.29.0These annotations are no longer shipped as defaults in the Helm charts but are still required for oauth2-proxy authentication to work. Add them to the custom Helm values before upgrading to preserve this behavior.
nginx.ingress.kubernetes.io/auth-response-headers: X-Auth-Request-Access-Token,Authorization
nginx.ingress.kubernetes.io/auth-signin: https://$host/oauth2/start?rd=$escaped_request_uri
nginx.ingress.kubernetes.io/auth-url: http://oauth2-proxy.oauth2-proxy.svc.cluster.local:80/oauth2/auth
Hotfixes
- 2.28.1 · GitHub Tag ↗ – May 21, 2026
CodeMie 2.27.0
Release Date: May 18, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
USE_POSTGRESremoved from AI/Run CodeMie Backend Helm Chart — this variable was deprecated and is no longer supported.Configuration housekeepingIf the
AI/Run CodeMie BackendHelm Chart values still containUSE_POSTGRES, it can be safely removed. -
Post-migration cleanup — if the Platform-Managed Mode migration has been completed but the one-time migration variables have not yet been removed, this is a good time to clean them up.
Post-migration housekeepingAfter a successful migration, the following variables are no longer needed and should be removed from
extraEnv:KEYCLOAK_MIGRATION_ENABLEDKEYCLOAK_ADMIN_URLKEYCLOAK_ADMIN_REALMKEYCLOAK_ADMIN_CLIENT_IDKEYCLOAK_ADMIN_CLIENT_SECRET
See Disable migration after the first run for the full cleanup steps.
-
LITELLM_PREMIUM_MODELS_ALIASESformat changed to JSON array — if this variable is in use, update its value from a comma-separated string to a JSON array.Format change requiredThe previous comma-separated format is no longer supported. Update
extraEnvbefore upgrading:# Before
- name: LITELLM_PREMIUM_MODELS_ALIASES
value: "opus,o1"
# After
- name: LITELLM_PREMIUM_MODELS_ALIASES
value: '["opus", "o1"]' -
LITELLM_PREMIUM_MODELS_BUDGET_NAMEremoved — this variable was deprecated and is no longer supported. Remove it fromextraEnvif still present.Configuration housekeepingThe budget name is now derived automatically from the
budget_category: premium_modelsentry inbudgets-config.yaml. No replacement variable is needed.
CodeMie 2.26.0
Release Date: May 12, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
-
Update LiteLLM budget env vars — remove
LITELLM_SPEND_COLLECTOR_SCHEDULEand setLLM_PROXY_BUDGET_BACKFILL_ENABLED: "true". See Budget Configuration. -
One-time reconciliation via
LLM_PROXY_BUDGET_RECONCILIATION_ENABLEDOne-time operationEnable only on a single API replica, wait for reconciliation to complete (check pod logs), then disable and scale replicas back.
Steps:
- Scale API to 1 replica.
- Set
LLM_PROXY_BUDGET_RECONCILIATION_ENABLED: "true". - Wait for reconciliation log confirmation.
- Remove or set the variable to
"false". - Scale API replicas back to the desired count.
Hotfixes
- 2.26.1 · GitHub Tag ↗ – May 13, 2026
CodeMie 2.25.0
Release Date: May 8, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
Known Issues
If your deployment has the LiteLLM proxy integration enabled, it is strongly recommended to skip this version and upgrade directly to CodeMie 2.26.0.
Version 2.25.0 contains a known issue that causes instability in environments with LiteLLM configured. Upgrading to 2.26.0 resolves this issue.
CodeMie 2.24.0
Release Date: April 23, 2026 · GitHub Tag ↗
Third-Party Component Updates
LiteLLM 1.83.7 (CodeMie 2.24.1)
Updated from 1.81.0. For details, see the LiteLLM 1.83.7 Release Notes ↗.
Configuration Changes
-
[BREAKING] Fluent Bit: Remove
span_idandtrace_idfrom Metrics LogsBreaking ChangeWithout this configuration update, no metrics will be written to the
codemie_metrics_logsElasticsearch index. Apply this change before or during the upgrade to CodeMie 2.24.0.A new
[FILTER]block must be added tofluent-bit/values.yamlto stripspan_idandtrace_idfields from CodeMie metrics logs before they are forwarded to Elasticsearch.Why: Starting with CodeMie 2.24.0, the backend includes
span_idandtrace_idfields in its log output. These fields are not accepted by thecodemie_metrics_logsElasticsearch index, causing all metrics ingestion to fail.Required change in
fluent-bit/values.yaml:[FILTER]
Name record_modifier
Match kube.codemie-metrics.*
Remove_key span_id
Remove_key trace_idThis filter is included in the updated
codemie-helm-charts. No manual action is required if you are upgrading using the provided Helm charts. -
Keycloak Login Theme
The CodeMie login theme (
codemie) is now automatically applied to thecodemie-prodrealm via theoauth2-proxyHelm chart.Upgrade instructions: Keycloak Theme Setup
-
New Environment Variable:
INTERNAL_BIND_KEYA new
INTERNAL_BIND_KEYenvironment variable has been introduced. It is a shared secret for inter-process communication. Without it, webhook trigger may fail when running multiple workers (WORKERS > 1) or multiple pod replicas.If upgrading using Helm charts:
The updated Helm chart automatically creates a Kubernetes Secret with a random value for
INTERNAL_BIND_KEY. No manual action is required for standard deployments.ArgoRollout deploymentsAutomatic secret generation is skipped when
argoRolloutis enabled. Create the Kubernetes Secret manually and reference it viasecurity.processAuthSecret.nameandsecurity.processAuthSecret.field.If deploying without Helm charts:
Set
INTERNAL_BIND_KEYto the same strong random value across all workers and pods. Generate with:openssl rand -hex 32. Store in a secrets manager or Kubernetes Secret.See API Configuration for full details.
Hotfixes
-
2.24.1 – April 29, 2026
Updated LiteLLM to 1.83.7. For details, see the LiteLLM 1.83.7 Release Notes ↗.
CodeMie 2.23.0
Release Date: April 15, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
Budget Enforcement Environment Variables
Three new environment variables have been introduced to control LLM budget enforcement. All default to false (disabled):
| Variable | Default | Description |
|---|---|---|
LLM_PROXY_BUDGET_CHECK_ENABLED | false | Enables budget limit checking for LLM proxy requests |
LLM_PROXY_BUDGET_SYNC_ENABLED | false | Syncs predefined budgets from budgets-config.yaml into the database on startup |
LLM_PROXY_BUDGET_BACKFILL_ENABLED | false | Backfills user budget assignments from LiteLLM on startup for existing users |
See Budget Configuration and API Configuration for details.
Deprecated Budget Environment Variables
The following environment variables are deprecated and will be removed in a future release. Replace them with the corresponding budgets-config.yaml fields:
| Deprecated Variable | Type | Default | Replacement in budgets-config.yaml |
|---|---|---|---|
DEFAULT_SOFT_BUDGET_LIMIT | float | 200 | soft_budget |
DEFAULT_HARD_BUDGET_LIMIT | float | 500 | max_budget |
DEFAULT_BUDGET_DURATION | string | "30d" | budget_duration |
DEFAULT_BUDGET_ID | string | "default" | budget_id |
LITELLM_PREMIUM_MODELS_BUDGET_NAME | string | "" | premium_models category entry |
LITELLM_CLI_BUDGET_NAME | string | "" | cli category entry |
See Budget Configuration for migration details.
Hotfixes
- 2.23.1 · GitHub Tag ↗ – April 15, 2026
- 2.23.2 · GitHub Tag ↗ – April 16, 2026
- 2.23.3 · GitHub Tag ↗ – April 21, 2026
- 2.23.4 · GitHub Tag ↗ – April 20, 2026
CodeMie 2.22.0
Release Date: April 9, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
Hotfixes
- 2.22.1 · GitHub Tag ↗ – April 9, 2026
CodeMie 2.21.0
Release Date: April 8, 2026 · GitHub Tag ↗
Third-Party Component Updates
oauth2-proxy 7.15.1 (Chart 10.4.2)
Updated oauth2-proxy from 7.14.2 to 7.15.1 (Helm chart 10.1.0 to 10.4.2). For details, see the oauth2-proxy 7.15.1 Release Notes ↗.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.20.0
Release Date: April 2, 2026 · GitHub Tag ↗
Third-Party Component Updates
ElasticSearch / Kibana 8.19.12
Updated from 8.18.4. For details, see the Elastic 8.19.12 Release Notes ↗.
Upgrade instructions: ElasticSearch and Kibana Upgrade Guide
NATS Chart 1.3.0 (NATS 2.11.0, Reloader 0.22.3)
Updated NATS Helm chart from 1.2.6 to 1.3.0, which includes NATS server 2.11.0 (up from 2.10.22) and NATS Reloader 0.22.3 (up from 0.16.0).
Upgrade instructions: NATS Upgrade Guide
Keycloak 26.5.6 (keycloakx 7.1.9)
Updated Keycloak to 26.5.6 (up from 26.4.5) and keycloakx chart to 7.1.9 (up from 7.1.5). For details, see the Keycloak 26.5 Release Notes ↗.
Upgrade instructions: Keycloak Upgrade Guide
Nginx 1.15.1
Updated nginx ingress controller to version 1.15.1 (up from 1.14.3).
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.19.0
Release Date: March 27, 2026 · GitHub Tag ↗
Third-Party Component Updates
Postgres Operator Removed
CodeMie 2.19.0 removes the postgres-operator Helm chart (PGO 5.4.3) used for Keycloak's in-cluster PostgreSQL. It is replaced by two new database options:
- Dedicated database instance — a separate, Terraform-provisioned database instance for Keycloak (default for Terraform deployments)
- Shared CodeMie database — Keycloak reuses the existing CodeMie database instance; a Helm hook Job automatically creates the required database and user on first install
See the Keycloak Database Migration Guide for upgrade instructions.
Migration to an external database is optional. If you prefer to continue using the in-cluster PostgreSQL, no migration is required when upgrading to 2.19.0.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.18.0
Release Date: March 24, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.17.0
Release Date: March 20, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.16.0
Release Date: March 18, 2026 · GitHub Tag ↗
Third-Party Component Updates
No third-party component updates in this release.
Configuration Changes
No breaking configuration changes were introduced in this release.
CodeMie 2.15.0
Release Date: March 16, 2026 · GitHub Tag ↗
Third-Party Component Updates
Fluent Bit 4.2.3.1
CodeMie 2.15.0 includes Fluent Bit version 4.2.3.1, providing improved log collection and processing capabilities.
What's new:
For detailed information about changes, improvements, and bug fixes, see the Fluent Bit 4.2.3.1 Release Notes.
Upgrade instructions:
To upgrade Fluent Bit to version 4.2.3.1, follow the Fluent Bit Upgrade Guide.
Configuration Changes
No breaking configuration changes were introduced in this release. All existing Fluent Bit configurations remain compatible.