IMPORTANT: Starting from September 2025, the CloudNativePG project has fully transitioned to the new Docker bake-based build process for the main PostgreSQL container images. Consequently, the CloudNativePG PostGIS images will now also be built on top of these new base images.

---

CNPG PostGIS Container Images

This repository provides scripts and definitions for building immutable application container images that bundle PostGIS with PostgreSQL. These images are built on top of the official CNPG PostgreSQL container images project and are maintained for the latest PostGIS major version (currently 3), across all supported PostgreSQL releases, on the following base variants:

• standard – without Barman Cloud
• system – with Barman Cloud

Images are maintained in accordance with the PostgreSQL and Debian lifecycles, following the postgres-containers policy—except that Debian oldoldstable is not supported—and are contingent upon the availability of Apt packages from the PostgreSQL Global Development Group (PGDG).

Images are available via the ghcr.io/cloudnative-pg/postgis registry, and intended exclusively as operands of the CloudNativePG (CNPG) operator in Kubernetes environments. They are not designed for standalone use.

⚠️ IMPORTANT: This project is transitional. The long-term plan is to decommission it once PostgreSQL 17 reaches end of life (November 2029). Starting with PostgreSQL 18, the extension_control_path GUC will allow PostGIS to be mounted as a separate image volume, removing the need for dedicated PostGIS container images.

Image Tags

Each image is identified by its digest and a main tag of the form:

MM.mm-x.y.z-TS-TYPE-OS

where:

• MM is the PostgreSQL major version (e.g. 17)
• mm is the PostgreSQL minor version (e.g. 6)
• x is the PostGIS major version (e.g. 3)
• y is the PostGIS minor version (e.g. 6)
• z is the PostGIS patch version (e.g. 0)
• TS is the build timestamp with minute precision (e.g. 202509221231)
• TYPE is image type (e.g. minimal)
• OS is the underlying distribution (e.g. trixie)

For example: postgis-testing:17.6-3.6.0-202509221231-system-trixie.

Rolling Tags

In addition to fully qualified tags, rolling tags are available in the following formats:

• MM.mm-x.y.TYPE-OS: latest image for a given PostgreSQL minor version (17.6) with a given PostGIS minor version (3.6) of a specific type (minimal) on a Debian version (trixie). For example: 17.6-3.6-minimal-trixie.
• MM-x.y.TYPE-OS: latest image for a given PostgreSQL major version (17) with a given PostGIS minor version (3.6) of a specific type (minimal) on a Debian version (trixie). For example: 17-3.6-minimal-trixie.
• MM-x-TYPE-OS: latest image for a given PostgreSQL major version (17) with a given PostGIS major version (3) of a specific type a specific type (minimal) on a Debian version (trixie). For example: 17-3-minimal-trixie.

Image Catalogs

CloudNativePG publishes ClusterImageCatalog manifests for PostGIS in the image-catalogs folder, with one catalog available for each supported combination of image type and operating system version.

License and copyright

This software is available under Apache License 2.0.

Copyright The CloudNativePG Contributors.

Licensing information of all the software included in the container images is in the /usr/share/doc/*/copyright* files.

---

We are a Cloud Native Computing Foundation Sandbox project.

---

CloudNativePG was originally built and sponsored by EDB.

---

Postgres, PostgreSQL, and the Slonik Logo are trademarks or registered trademarks of the PostgreSQL Community Association of Canada, and used with their permission.