Aktualizováno: 2026-10-05 · Platí pro: PostgreSQL 17 (Docker image postgres); umbrelOS

Záloha PostgreSQL přes pg_dump

Cíl: pravidelný, konzistentní dump databáze PostgreSQL běžící v Dockeru, který přežije i zálohu celého serveru za běhu a jde obnovit i do novější verze PostgreSQL.
Předpoklady: přístup do shellu hostitele (SSH), práva spouštět docker, adresář, který se dál zálohuje (USB disk, NAS, záloha Umbrelu).

Proč dump, a ne jen záloha souborů

• Kopie datového adresáře je spolehlivá jen při vypnutém serveru. Záloha za běhu může obsahovat databázi v nekonzistentním stavu. dok. PostgreSQL
• pg_dump dělá konzistentní snapshot za běhu a neblokuje provoz. Jeho výstup jde načíst i do novější verze, takže slouží zároveň jako pojistka před upgradem (17 → 18). dok. PostgreSQL
• Syntéza: zálohy celého serveru (např. umbrelOS) nech běžet dál a dump ukládej do adresáře, který tato záloha zahrnuje. Záloha serveru pak přenese i konzistentní dump.

Postup

1. Zjisti název kontejneru, uživatele a databázi:

   docker ps --format '{{.Names}}' | grep -i postgres
   docker exec <kontejner> psql -U <uživatel> -l
   

2. Ruční dump v custom formátu (komprimovaný, obnova přes pg_restore). dok. PostgreSQL pg_dump se spouští uvnitř kontejneru, takže verze klienta odpovídá serveru (Syntéza).

   docker exec <kontejner> pg_dump -U <uživatel> -Fc <databáze> > /cesta/k/zaloham/<databáze>-$(date +%F).dump
   

3. Volitelně role a další globální nastavení. pg_dump je nezálohuje. dok. PostgreSQL

   docker exec <kontejner> pg_dumpall -U <uživatel> --globals-only > /cesta/k/zaloham/globals-$(date +%F).sql
   

4. Skript pro pravidelné spouštění s mazáním starých dumpů (Syntéza), např. pg-backup.sh:

   #!/bin/sh
   set -e
   CONTAINER=<kontejner>
   DB=<databáze>
   DBUSER=<uživatel>
   DIR=/cesta/k/zaloham
   KEEP_DAYS=14
   
   TMP="$DIR/$DB-$(date +%F_%H%M).dump.part"
   docker exec "$CONTAINER" pg_dump -U "$DBUSER" -Fc "$DB" > "$TMP"
   mv "$TMP" "${TMP%.part}"
   find "$DIR" -name "$DB-*.dump" -mtime +"$KEEP_DAYS" -delete
   

   Soubor .part se přejmenuje až po úspěšném dumpu, takže nedokončený dump nevypadá jako platná záloha.
5. Naplánuj ho přes cron, např. denně ve 3:00, před zálohou celého serveru:

   0 3 * * * /cesta/k/pg-backup.sh >> /cesta/k/zaloham/pg-backup.log 2>&1
   

Ověření

• Obsah dumpu (bez obnovy): docker exec -i <kontejner> pg_restore -l < soubor.dump | head
• Zkušební obnova do testovací databáze (Syntéza: záloha, kterou jsi nikdy neobnovil, není ověřená):

  docker exec <kontejner> createdb -U <uživatel> -T template0 restore_test
  docker exec -i <kontejner> pg_restore -U <uživatel> -d restore_test < soubor.dump
  docker exec <kontejner> dropdb -U <uživatel> restore_test
  

  Postup s createdb -T template0 a pg_restore -d podle dok. PostgreSQL.

Obnova

• Do nové prázdné databáze: createdb -T template0 <databáze> a pak pg_restore -d <databáze> soubor.dump (přes docker exec -i jako výše). dok. PostgreSQL
• Při obnově do nové instalace nejdřív načti globals-*.sql (role) přes psql, pak databázi.
• Syntéza: před obnovou do produkční databáze zastav toky v Node-RED, které do ní zapisují.

Troubleshooting

• pg_dump chce heslo: předej ho proměnnou prostředí jen pro daný příkaz (docker exec -e PGPASSWORD=… …), nikdy ho nepiš do wiki ani do repa. Syntéza.
• Prázdný nebo malý dump: špatná databáze nebo uživatel, zkontroluj krok 1 a pg-backup.log.
• Restore hlásí chybějící role: nejdřív obnov globals-*.sql.

Souvislosti

• PostgreSQL, Docker, Umbrel Home, Node-RED

Zdroje

• PostgreSQL: oficiální Docker image + dokumentace 17 (zálohy, upgrade): SQL dump, custom formát, pg_restore, pg_dumpall --globals-only, záloha souborů jen při vypnutém serveru.
• umbrelOS / Umbrel Home (README, app store, produktová stránka): aplikace jako Docker Compose projekty, data v ${APP_DATA_DIR}.