Anleitung: PostgreSQL-Major-Upgrade

[ledermann]

SOLECTRUS verwendet PostgreSQL als relationale Datenbank, um u.a. die Tageszusammenfassungen zu verwalten. Diese werden zukünftig noch wichtiger werden, ich arbeite derzeitig an internen Verbesserungen für SOLECTRUS.

PostgreSQL erhält einmal im Jahr ein größeres Upgrade ("Major-Upgrade"), vor wenigen Tagen ist die Version 18 erschienen. Die Installation eines Major-Upgrades ist bei PostgreSQL allerdings etwas aufwändiger, da man ein Backup mit nachfolgendem Restore machen muss. Minor-Updates hingegen, die mehrmals pro Jahr erscheinen, sind unproblematisch und werden von Watchtower automatisch installiert (oder manuell mit docker compose pull && docker compose up -d).

In der allerersten Installationsanleitung für SOLECTRUS aus dem Jahr 2021 wird noch PostgreSQL 13 verwendet, sodass es heute vermutlich immer noch Nutzer gibt, die eine sehr alte Version von PostgreSQL betreiben. Da der Support für Version 13 in Kürze endet (es gibt dann keine Minor-Updates mehr), empfiehlt sich ein Upgrade, am besten auf die aktuelle Version 18.

Welche Version von PostgreSQL in Verwendung ist, lässt sich so herausfinden:

$ cd solectrus

$ docker compose ps
NAME                             IMAGE                                          ...
...
solectrus-postgresql-1           postgres:18-alpine                             ...
...

Hier in diesem Beispiel wird bereits die aktuelle Version 18 angezeigt (postgres:18-alpine), bei den meisten Nutzern wird es eine Version zwischen 13 und 17 sein.

Ich habe nun eine Schritt-für-Schritt-Anleitung erstellt, mit der jeder das Upgrade auf Version 18 schnell und einfach durchführen kann:
https://docs.solectrus.de/referenz/postgresql/upgrade

EDIT 28.09.2025: Damit sich niemand unnötig stresst: Dieses Datenbank-Upgrade ist für SOLECTRUS nicht zwingend erforderlich. Auch mit einer sehr alten PostgreSQL-Version läuft SOLECTRUS weiterhin. Meine Empfehlung zum Upgrade spreche ich nur deshalb aus, weil mit PostgreSQL 13 die älteste jemals von SOLECTRUS genutzte Version bald das Ende ihres Lebenszyklus erreicht (einzige Konsequenz: Keine Minor-Updates mehr). Wer PostgreSQL 14 oder neuer einsetzt, muss sich nicht drängen lassen und kann das Upgrade bei Unsicherheit auch erst einmal verschieben.

Mich würde interessieren, welche PostgreSQL-Versionen wirklich bei Euch im Einsatz sind und ob das Upgrade geklappt hat. Wer bezüglich Docker und Linux etwas unsicher ist, wartet vielleicht besser auf die ersten Erfolgsmeldungen anderer User. Kommentare erwünscht :)

[gereons]

Der Update (von 17 auf 18) hat bei mir problemlos geklappt, danke für die sehr gute Anleitung.

[Zeppelin-PV]

meine Solectrus Instanz läuft noch mit der PostgreSQL Version 15 - kann jedoch erst updaten nach der REHA, Mitte Oktober
von hier aus habe ich zwar Zugriff, aber das ist mir zu riskant

[Zeppelin-PV]

Update auf PostgreSQL Version 18 erfolgreich - dank Deiner exzellenten Beschreibung, Georg.

[hambue]

Das Update von 15 auf 18 hat schlussendlich geklappt. Hatte zunächst aber diese Fehlermeldung:
service "postgresql" is not running

Dadurch fiel mir auf, dass dieser Service bei mir db heißt. Habe dann einfach in den entsprechenden Befehlen der Anleitung postgresql durch db ersetzt.

[ledermann]

Sehr guter Hinweis, danke! In frühen Installationsanleitungen hieß der Service tatsächlich noch db. Ich hatte das später geändert, um eine deutliche Unterscheidung zu influxdb zu haben. Aber es sind natürlich noch viele Installationen da draußen, bei denen es noch db heißt.

Ich habe die Upgrade-Anleitung jetzt um einen Hinweis ergänzt. In dem Zusammenhang auch: Der Ordner mit der Datenbank kann an einem anderen Ort liegen. Bei Synology ist beispielsweise /volume1/docker/solectrus/postgresql üblich. Auch das muss in einigen Befehlen berücksichtigt werden.

[halmich]

Bei mir lief 15, und nun nach dem Update läuft erfolgreich 18. Danke!

[k-ranseier]

Sodele, als Linux-Noob hat alles genau so wie in Georgs Anleitung beschrieben geklappt. Aber mit Schweiss auf der Stirn und einem Kaltgetränk!
Update war von 16 auf 18.
Solectrus hatte ich im Oktober 24 über den Configurator neu aufgesetzt.

[bennysweb]

Hat bei mir auch problemlos von Version 16 funktioniert. Habe bei der Gelegenheit gleich "db" in "postgresql" umbenannt. Wer das auch machen möchte, muss folgende Einträge in der compose.yaml anpassen (vorher auch den Dienst "app" stoppen mit "docker compose stop app"):

• service app -> depends_on -> "db" umbennen in "postgresql"
• service app -> links -> "db" umbennen in "postgresql"
• service app -> environment -> "- DB_HOST=db" umbennen in "- DB_HOST=postgresql"
• service db -> umbennen in "postgresql"
  Dann mit "docker compose start app" die App wieder starten und mit Georgs Anleitung fortfahren.

[unclej84]

Ich kann an dieser Stelle nur dieses Repository empfehlen - hat bei mir beim Upgrade von 14 auf 16 (bin aktuell auf 16) hervorragend funktioniert: https://github.com/tianon/docker-postgres-upgrade

[patricknitsch]

Das Upgrade auf V18 hat nach deiner Anleitung problemlos funktioniert. Danke!

[Felliglanz]

ich habe das update von 17 auf 18 auch mal probiert. Da ich den Stack via Portainer verwalte, kann ich vermutlich die Anleitung nicht zu 100% verwenden. Gebe ehrlich zu, meine Kentnisse mit Docker sind eher noch in den Kinderschuhen ;) Also wenn hier jemand ist, der das in Portainer umgesetzt bekommen hat, ich wäre dankbar für einen Ratschlag. Da 17 habe ich keine Eile aber warum nicht, aktuell ist aktuell. Danke schon mal!

[deThommy]

würde mich auch interessieren. verwalte solectrus auch mittels portainer, bin aktuell auf postgre version 16 und schiebe daher erstmal... :)

[patricknitsch]

Hallo,

bei mir läuft Solectrus ebenfalls über Portainer. War aber keine große Umstellung. Über ssh einloggen, der Anleitung von Georg folgen und später das compose file in Portainer ändern. Du musst halt zweigleisig fahren, da nicht alles über das Terminal erfolgt. Oder du weist, wo Portainer die files ablegt, dann geht alles :)

[Felliglanz]

Okay das klingt interessant! Loggst Du Dich dann in die Shell des Containers direkt ein oder einfach über die CLI des Docker Host? Dann werde ich das mal so testen in meinem Setup. Danke für Deinen Input!

[patricknitsch]

Ich gehe über den Host. Ist für mich einfacher, da meine Container alle an einem zentralen Punkt ihre Daten speichern. So kann ich diese regelmäßig für Backups abgreifen.

[Felliglanz]

Danke Patrick das hat super geklappt :D Habs zunächst in Portainer probiert aber bin immer gescheitert, via CLI ging es in unter 5 Minuten!! Auch danke an Georg für die Anleitung !! Euch allen einen schönen Feiertag und ebenso das Wochenende ;)

LG
Sven