https://github.com/cloudnative-pg/postgis-containers
Operand images for CloudNativePG containing PostgreSQL with PostGIS
https://github.com/cloudnative-pg/postgis-containers
cloudnativepg container-images postgis postgres postgresql
Last synced: 4 months ago
JSON representation
Operand images for CloudNativePG containing PostgreSQL with PostGIS
- Host: GitHub
- URL: https://github.com/cloudnative-pg/postgis-containers
- Owner: cloudnative-pg
- License: apache-2.0
- Created: 2022-07-24T14:10:51.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T00:30:04.000Z (10 months ago)
- Last Synced: 2025-04-11T01:28:16.203Z (10 months ago)
- Topics: cloudnativepg, container-images, postgis, postgres, postgresql
- Language: Dockerfile
- Homepage:
- Size: 1.41 MB
- Stars: 27
- Watchers: 6
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
[](https://cloudnative-pg.io/)
> **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](https://github.com/cloudnative-pg/postgres-containers).
> 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](https://github.com/cloudnative-pg/postgres-containers)
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`](https://github.com/cloudnative-pg/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)](https://wiki.postgresql.org/wiki/Apt).
Images are available via the
[`ghcr.io/cloudnative-pg/postgis` registry](https://github.com/cloudnative-pg/postgis-containers/pkgs/container/postgis),
and intended exclusively as **operands of the [CloudNativePG (CNPG) operator](https://cloudnative-pg.io)**
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](image-catalogs), 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](LICENSE).
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.