// Bitnami alternatives / postgresql

Bitnami PostgreSQL alternative
Replacing bitnamilegacy/postgresql

The bitnamilegacy/postgresql image has had about 16.9 million pulls since Bitnami moved it to the legacy repository, and it receives no updates. Switching to the official postgres image means changing environment variables and the data path. Get either wrong and the new container starts empty.

Trusted globally by enterprises

Henry ScheinEnbridgeGojekMicrosoft

Bitnami PostgreSQL variables and their official equivalents

Bitnami PostgreSQL image to official postgres:

SettingBitnamiOfficial image
Superuser or app userPOSTGRESQL_USERNAMEPOSTGRES_USER
PasswordPOSTGRESQL_PASSWORDPOSTGRES_PASSWORD
DatabasePOSTGRESQL_DATABASEPOSTGRES_DB
Empty password in developmentALLOW_EMPTY_PASSWORDPOSTGRES_HOST_AUTH_METHOD=trust
Data path/bitnami/postgresql/var/lib/postgresql (PGDATA)

What breaks when you switch

  • The volume is mounted at /bitnami/postgresql. The official image looks under /var/lib/postgresql, so an unchanged volume mount starts an empty database.
  • Bitnami's replication variables (POSTGRESQL_REPLICATION_*) have no official equivalent; replication has to be configured explicitly or handed to an operator.
  • The Bitnami image runs as a non-root user. Check ownership of existing volumes before switching users.

What happened to the Bitnami PostgreSQL image

For years, bitnami/postgresql on Docker Hub was one of the most common ways to deploy PostgreSQL on Kubernetes, usually through the Bitnami PostgreSQL Helm chart. On 28 August 2025 Broadcom moved every versioned Bitnami container image, including this one, to the bitnamilegacy repository, and removed the public docker.io/bitnami catalog on 29 September 2025. The free tier now offers only latest tags of a limited set of images for development.

The legacy Docker image still pulls, so existing deployments keep working. It no longer receives updates, which means every vulnerability disclosed since the move stays open in the PostgreSQL binary, in the base image and in every bundled dependency. Container scanners will report a growing count at every audit, and a workload that depends on a frozen public repository is one registry change away from ImagePullBackOff.

How to migrate PostgreSQL off Bitnami safely

  1. Find every reference to bitnami/postgresql and bitnamilegacy/postgresql in running workloads, Helm values files and CI pipelines, including init containers.
  2. Record the PostgreSQL version each deployment pins. Versions past upstream end of life are not covered by the free open source images.
  3. Take a backup and test a restore before touching a stateful workload.
  4. Mirror the replacement container images into your own registry, and scan them before you deploy.
  5. Move one replica or one environment at a time, and confirm the data path, file ownership and credentials on the new image.
  6. Remove every remaining legacy reference so nothing falls back to the archive on the next deploy.

Your options

OSSeva drop-in image

A patched image that keeps Bitnami's variables, paths and user, covering PostgreSQL 11 to 14, including versions past community end of life. Your chart keeps working after a registry change.

Official postgres image

Free and maintained for current versions. Apply the mapping above and move the volume.

CloudNativePG

A CNCF operator for PostgreSQL on Kubernetes, and the usual long-term replacement for the Bitnami postgresql and postgresql-ha charts.

Bitnami Secure Images

Broadcom's paid catalog keeps the Bitnami layout for supported versions, sold within TrueSource.

Repoint the Bitnami PostgreSQL Helm chart

# values-override.yaml
image:
  registry: registry.example.com   # your mirror of the replacement image
  repository: postgresql
  tag: "<pinned version>"
global:
  security:
    allowInsecureImages: true      # recent Bitnami charts reject non-Bitnami images without this

This works only with an image that keeps Bitnami's layout. With the official image, rewrite the chart or move to an operator. See replacing bitnamilegacy images for the full inventory and rollout steps.

Frequently asked questions

What is the best alternative to the Bitnami PostgreSQL image?

To keep the Bitnami PostgreSQL Helm chart unchanged, use a Bitnami-compatible image; OSSeva ships patched ones covering PostgreSQL 11 to 14, including versions past community end of life. To rewrite the deployment, use the official postgres image or CloudNativePG.

Is bitnamilegacy/postgresql still getting security updates?

No. Bitnami moved versioned images to the bitnamilegacy repository on 28 August 2025 and describes it as receiving no further updates. It had about 16.9 million pulls by September 2026.

Can I keep using the Bitnami PostgreSQL Helm chart?

Yes, with a maintained image that keeps Bitnami's layout. Set image.registry and image.repository in your values file, and set global.security.allowInsecureImages to true, because recent Bitnami charts refuse non-Bitnami images otherwise.

Is Bitnami no longer free?

Not for production. Since 28 August 2025, versioned Bitnami images live in the bitnamilegacy repository with no updates, and the free tier offers latest tags of a limited set of images for development. Maintained, versioned images are sold as Bitnami Secure Images, which Broadcom prices by quote.

Where does the Bitnami PostgreSQL image store data?

Under /bitnami/postgresql. The official image uses /var/lib/postgresql (PGDATA), so the volume mount must change when you switch images.

Keep your PostgreSQL chart. Change the image.

Send us your image list and versions; we reply with coverage and a migration plan within five working days.