litellm - 💡(How to fix) Fix [Bug]: Helm chart default image tag main-<appVersion> does not exist on ghcr for stable releases → ImagePullBackOff

Check for existing issues

• I have searched the existing issues and checked that my issue is not a duplicate.

What happened?

Installing oci://ghcr.io/berriai/litellm-helm with no image.tag override fails with ImagePullBackOff. The chart's default renders an image tag that is not published to ghcr.io/berriai/litellm-database.

Root cause

templates/deployment.yaml and templates/migrations-job.yaml both default the tag to main-<AppVersion>:

image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default (printf "main-%s" .Chart.AppVersion) }}"

For chart 1.86.2 (AppVersion: 1.86.2) this renders ghcr.io/berriai/litellm-database:main-1.86.2, which returns 404. The registry has the plain 1.86.2 tag (and main-stable), but not main-1.86.2.

This is systemic across recent stable releases

Anonymous manifest checks on ghcr.io/berriai/litellm-database:

The published 1.86.2 tag and main-stable resolve to the same digest (sha256:7b4494a6b2e366bf17ece8e3a84a5a92d5ce6c9309115cc6d65d71766fc59242), confirming the image exists — only the main-<version> tag the chart constructs is missing.

Impact

A default install of any recent stable chart version cannot pull the app/migrations image; pods sit in ImagePullBackOff until the user manually overrides image.tag. Affects both the main Deployment and the DB migrations Job.

Workaround

image:
  tag: "1.86.2"   # immutable; same digest as main-stable

Suggested fix

Either publish a main-<AppVersion> tag as part of the stable release pipeline, or change the chart's default to .Chart.AppVersion (the plain <version> tag is consistently published).

Steps to Reproduce

helm template litellm oci://ghcr.io/berriai/litellm-helm --version 1.86.2 | grep litellm-database

1. see that the image tag is ghcr.io/berriai/litellm-database:main-1.86.2
2. docker pull of ghcr.io/berriai/litellm-database:main-1.86.2 is failing with 404 not found

Relevant log output

What part of LiteLLM is this about?

Other

What LiteLLM version are you on ?

1.86.2

Twitter / LinkedIn details

No response