# Regression in PostGIS extension, and wrong documentation

**URL:** <https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933>\
**Category:** PostgreSQL\
**Created:** [December 23, 2025, 3:24pm UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933 "2025-12-23T15:24:09Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![SelectStar](https://avatars.discourse-cdn.com/v4/letter/s/9fc348/32.png) [@SelectStar](https://forums.percona.com/u/SelectStar)\
**Post date:** [December 23, 2025, 3:24pm UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933/1 "2025-12-23T15:24:09Z")

</div>

The installation instructions on [Use PostGIS extension - Percona Operator for PostgreSQL](https://docs.percona.com/percona-operator-for-postgresql/latest/postgis.html) break on step 6, because that “image” URL doesn’t exist in deploy/cr.yaml. I think it’s been moved to deploy/operator.yaml, but even when I change it in there and “kubectl apply -f deploy/operator.yaml -n postgres-operator”, the pod fails with the error “/opt/crunchy/bin/uid\_postgres.sh no such file or directory”.

Workaround: “git checkout v2.7.0” and then change the “image” value in deploy/cr.yaml to “[docker.io/percona/percona-postgresql-operator:2.7.0-ppg17.5.2-postgres-gis3.3.8”](http://docker.io/percona/percona-postgresql-operator:2.7.0-ppg17.5.2-postgres-gis3.3.8%E2%80%9D). Then it installs and runs perfectly with those instructions.

It seems like there was both some PostGIS regression between v2.7.0 and v2.8.0 / v2.8.1, and that your instructions on that page are outdated.

---

<div class="post-metadata">

**Author:** ![eleonora.zinchenko](https://sea1.discourse-cdn.com/flex019/user_avatar/forums.percona.com/eleonora.zinchenko/32/19132_2.png) [@eleonora.zinchenko](https://forums.percona.com/u/eleonora.zinchenko)\
**Post date:** [December 23, 2025, 4:36pm UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933/2 "2025-12-23T16:36:50Z")

</div>

Hi,

> A fter the Operator is started, modify the `deploy/cr.yaml` configuration file with PostGIS-enabled image - use `docker.io/percona/percona-postgresql-operator:2.8.1-ppg17.7-postgres-gis3.3.8` instead of `docker.io/percona/percona-postgresql-operator:2.8.1-ppg17.7-postgres`

Indeed there is an error in provided example. Not ``docker.io/percona/percona-postgresql-operator:2.8.1-ppg17.7-postgres` but `docker.io/percona/percona-distribution-postgresql:17.7-1` . I will create a task for our doc team to update example.

But I was able to start the cluster with gis image ‘`percona/percona-postgresql-operator:2.8.1-ppg17.7-postgres-gis3.3.8‘` image without issues. Can you provide more details steps to reproduce and/or your cr?

Also, are you using `v2.8.1` tag and or main branch? Because in main branch the `postgresVersion` is set to 18 and this indeed may lead to issues.

---

<div class="post-metadata">

**Author:** ![eleonora.zinchenko](https://sea1.discourse-cdn.com/flex019/user_avatar/forums.percona.com/eleonora.zinchenko/32/19132_2.png) [@eleonora.zinchenko](https://forums.percona.com/u/eleonora.zinchenko)\
**Post date:** [December 23, 2025, 4:47pm UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933/3 "2025-12-23T16:47:14Z")

</div>

Hi,

Please also note the note from PGO 2.8.1 operator release re **PostgreSQL RPMs rebuilt to disable debug assertions** [Percona Operator for PostgreSQL 2.8.1 (2025-12-16) - Percona Operator for PostgreSQL](https://docs.percona.com/percona-operator-for-postgresql/latest/ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.1.html#supported-software) . We are planning to release 2.8.2 in soon to fix this.

---

<div class="post-metadata">

**Author:** ![SelectStar](https://avatars.discourse-cdn.com/v4/letter/s/9fc348/32.png) [@SelectStar](https://forums.percona.com/u/SelectStar)\
**Post date:** [December 24, 2025, 6:55am UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933/4 "2025-12-24T06:55:52Z")

</div>

When I completely reset my whole Kubernetes environment, and re-ran the installation instructions from that page with this change as your proposed:

```yaml
diff --git a/deploy/cr.yaml b/deploy/cr.yaml
index ab2e5baf8..54d0563ec 100644
--- a/deploy/cr.yaml
+++ b/deploy/cr.yaml
@@ -154,7 +154,7 @@ spec:
 # test-label: value

- image: docker.io/percona/percona-distribution-postgresql:17.7-1
+ image: docker.io/percona/percona-postgresql-operator:2.8.1-ppg17.7-postgres-gis3.3.8
   imagePullPolicy: Always
   postgresVersion: 17
 # port: 5432

```

then it started working.

So it looks like just a documentation issue.

Thank you so much 😀.

---

<div class="post-metadata">

**Author:** ![eleonora.zinchenko](https://sea1.discourse-cdn.com/flex019/user_avatar/forums.percona.com/eleonora.zinchenko/32/19132_2.png) [@eleonora.zinchenko](https://forums.percona.com/u/eleonora.zinchenko)\
**Post date:** [December 24, 2025, 7:16am UTC](https://forums.percona.com/t/regression-in-postgis-extension-and-wrong-documentation/39933/5 "2025-12-24T07:16:28Z")

</div>

Hi @SelectStar ,

Thanks reaching back with update! Glad to hear it worked. JFYI: the task for updating docs [Jira](https://perconadev.atlassian.net/browse/K8SPG-928) .
