From 682dd4183efe418de189d8d6c53753d9ff84c326 Mon Sep 17 00:00:00 2001
From: cynfo3000 <cynfo3000@cynfo.net>
Date: Sun, 8 Mar 2026 21:14:18 +0100
Subject: [PATCH] docs: Debian 13 PostgreSQL-Versionskonflikt mit TimescaleDB
 dokumentiert

Debian 13 (Trixie) liefert PostgreSQL 17.8, TimescaleDB benoetigt >= 17.9.
Loesung: offizielles PostgreSQL-Apt-Repo (apt.postgresql.org/bookworm-pgdg)
statt Debian-eigene Pakete verwenden.
Fehlerbehebung fuer bestehende Installationen ebenfalls dokumentiert.
---
 docs/POSTGRES_SETUP.md | 38 +++++++++++++++++++++++++++++---------
 1 file changed, 29 insertions(+), 9 deletions(-)

diff --git a/docs/POSTGRES_SETUP.md b/docs/POSTGRES_SETUP.md
index d661710..4546dd6 100644
--- a/docs/POSTGRES_SETUP.md
+++ b/docs/POSTGRES_SETUP.md
@@ -8,14 +8,28 @@ Einrichtung von PostgreSQL mit TimescaleDB auf dem RMM-Backend-Server (Debian 13
 
 ## 1. PostgreSQL installieren
 
+> **Wichtig für Debian 13 (Trixie):** Das Standard-Debian-Repository liefert PostgreSQL 17.8,
+> TimescaleDB benötigt aber mindestens 17.9. Deshalb muss zuerst das **offizielle
+> PostgreSQL-Apt-Repository** eingerichtet werden — das liefert immer die aktuelle Version.
+
 ```bash
 apt update
-apt install -y postgresql postgresql-contrib postgresql-common
+apt install -y curl gnupg
+
+# Offizielles PostgreSQL-Repository einrichten
+curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc \
+  | gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
+
+echo "deb https://apt.postgresql.org/pub/repos/apt bookworm-pgdg main" \
+  > /etc/apt/sources.list.d/pgdg.list
+
+apt update
+apt install -y postgresql-17
 
 systemctl enable postgresql
 systemctl start postgresql
 
-# Version prüfen (Trixie liefert PG17)
+# Version prüfen — muss 17.9 oder neuer zeigen
 psql --version
 ```
 
@@ -24,17 +38,15 @@ psql --version
 ## 2. TimescaleDB installieren
 
 ```bash
-# Repository einrichten
-apt install -y curl gnupg
+# TimescaleDB-Repository einrichten
 echo "deb https://packagecloud.io/timescale/timescaledb/debian/ bookworm main" \
   > /etc/apt/sources.list.d/timescaledb.list
-curl -sL https://packagecloud.io/timescale/timescaledb/gpgkey | \
-  gpg --dearmor > /etc/apt/trusted.gpg.d/timescaledb.gpg
+curl -sL https://packagecloud.io/timescale/timescaledb/gpgkey \
+  | gpg --dearmor > /etc/apt/trusted.gpg.d/timescaledb.gpg
 apt update
 
-# Passende Version zu PG17 installieren
-apt install -y timescaledb-2-loader-postgresql-17=2.25.1~debian12-1708 \
-               timescaledb-2-postgresql-17=2.25.1~debian12-1708
+# TimescaleDB für PostgreSQL 17 installieren
+apt install -y timescaledb-2-postgresql-17
 
 # In postgresql.conf aktivieren
 sed -i "s/#shared_preload_libraries = ''/shared_preload_libraries = 'timescaledb'/" \
@@ -43,6 +55,14 @@ sed -i "s/#shared_preload_libraries = ''/shared_preload_libraries = 'timescaledb
 systemctl restart postgresql
 ```
 
+> **Falls der Install mit einem Abhängigkeitsfehler fehlschlägt** (`postgresql-17 >= 17.9 required`):
+> Das bedeutet, dass noch das Debian-eigene PostgreSQL 17.8 installiert ist.
+> Lösung:
+> ```bash
+> apt remove -y postgresql* && apt autoremove -y
+> # Dann Schritt 1 (PostgreSQL aus dem pgdg-Repo) wiederholen
+> ```
+
 ---
 
 ## 3. Datenbank und User anlegen