Einen Palaver-Server aktualisieren
zuletzt geändert
Voraussetzung: Server nach der Installationsanleitung
Ohne Paketquelle, aus den Release-Dateien: Update-Anleitung ohne Paketquelle
Platzhalter in den Befehlen:
| Platzhalter | Ersetzen durch |
|---|---|
0.3.0 |
vorige Palaver-Version, wie apt list -a palaver-server sie zeigt; eine Vorabversion mit ~, z. B. 0.3.2~rc.1 (Weg zurück) |
2026-10-11 |
heutiges Datum (Dateinamen der Sicherung) |
chat.example.org |
deinen Domainnamen (Blöcke der Installationsanleitung) |
<cert-name> |
Name des Zertifikats, falls er von der Domain abweicht |
vi |
Editor deiner Wahl |
1. Versionshinweise
- lesen: Versionshinweise jeder Version nach der installierten
- umsetzen: die dort genannten Änderungen (Konfigurationsdateien, nginx-Site, LiveKit-Version)
Zeige die installierte Version an.
/opt/palaver/bin/palaverd version
2. Sicherung
Sichere die Datenbank.
sudo -u palaver pg_dump -Fc palaver > palaver-2026-10-11.dump
Sichere die Konfiguration.
sudo tar -czf palaver-etc-2026-10-11.tar.gz -C /opt/palaver etc
3. Aktualisieren
Lade die Paketlisten.
sudo apt update
Installiere die neue Version; palaverd startet neu.
sudo apt upgrade
Zeige die neue Version an.
/opt/palaver/bin/palaverd version
4. LiveKit
Nur bei neuerem LiveKit in den Versionshinweisen. Zeige die installierte Version an.
/opt/palaver/bin/livekit-server --version
Download und Installation: Schritt 7 der Installationsanleitung, ohne die Konfiguration.
Starte LiveKit neu; laufende Gespräche brechen ab.
sudo systemctl restart livekit
5. Prüfen
Führe doctor aus; erwartet: kein Befund.
sudo -u palaver /opt/palaver/bin/palaverd -env /opt/palaver/etc/palaverd.env doctor
Öffne den Web-Client und melde dich an.
Einmalig: von Hand installierte Server
- für: nach der Installationsanleitung ohne Paketquelle oder vor dem Paket
palaver-servernach der Installationsanleitung installierte Server - einmalig, statt Schritt 3
Prüfe, dass das Paket noch nicht installiert ist; erwartet: is not installed.
dpkg -s palaver-server
Halte palaverd an und deaktiviere es.
sudo systemctl disable --now palaverd
Destruktiv: Entferne die von Hand geschriebene Unit (/etc/systemd/system/palaverd.service).
sudo rm /etc/systemd/system/palaverd.service
sudo systemctl daemon-reload
Destruktiv: Entferne die von Hand geschriebenen Dateien für Web-Snippet, Logrotation und Journal (/etc/nginx/snippets/palaver-web.conf, /etc/logrotate.d/palaver, /etc/systemd/journald@palaver.conf).
sudo rm /etc/nginx/snippets/palaver-web.conf /etc/logrotate.d/palaver /etc/systemd/journald@palaver.conf
Destruktiv: Entferne palaverd und den Web-Client (/opt/palaver/bin/palaverd, /opt/palaver/web).
sudo rm /opt/palaver/bin/palaverd
sudo rm -r /opt/palaver/web
Lade den Schlüssel der Paketquelle herunter.
sudo install -d -m 755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/palaver.gpg https://palaver.social/apt/palaver.gpg
Öffne /etc/apt/sources.list.d/palaver.list in einem Editor.
sudo vi /etc/apt/sources.list.d/palaver.list
Inhalt:
deb [arch=amd64 signed-by=/etc/apt/keyrings/palaver.gpg] https://palaver.social/apt stable main
Lade die Paketlisten.
sudo apt update
Installiere palaver-server.
sudo apt install palaver-server
Prüfe und lade nginx.
sudo nginx -t && sudo systemctl reload nginx
Aktiviere und starte palaverd.
sudo systemctl enable --now palaverd
Weiter: Schritt 4.
Einmalig: mit install.sh eingerichtete Server
- für: mit
install.sheingerichtete Server (Palaver 0.2.x) - einmalig, nach Einmalig: von Hand installierte Server
- Altlasten: Hilfsskript, Installationsprotokoll, nginx-Site ohne Web-Snippet
Zeige den Namen des Zertifikats an.
sudo ls /etc/letsencrypt/live/
Bewahre die alte nginx-Site außerhalb der nginx-Verzeichnisse auf.
sudo cp /etc/nginx/sites-available/palaver /root/nginx-palaver-2026-10-11.conf
Site /etc/nginx/sites-available/palaver: vollständige Site wie in Schritt 8 der Installationsanleitung.
Name des Zertifikats weicht von der Domain ab: öffne /etc/nginx/sites-available/palaver in einem Editor.
sudo vi /etc/nginx/sites-available/palaver
Ändere:
ssl_certificate,ssl_certificate_key:/etc/letsencrypt/live/chat.example.org/→/etc/letsencrypt/live/<cert-name>/
Prüfe und lade sie.
sudo nginx -t && sudo systemctl reload nginx
Destruktiv: Entferne das Hilfsskript (/usr/local/sbin/palaverctl).
sudo rm /usr/local/sbin/palaverctl
Destruktiv: Entferne das Installationsprotokoll (/var/log/palaver-install.log).
sudo rm /var/log/palaver-install.log
Destruktiv: Entferne die Datei mit dem Zertifikatsnamen von install.sh (/opt/palaver/etc/cert), falls vorhanden.
sudo rm /opt/palaver/etc/cert
Zurück zur vorigen Version
- für: neue Version funktioniert nicht
- Datenbankänderungen bleiben; falls nötig: Sicherung aus Schritt 2, wie unter Installationsanleitung, Wiederherstellen
Zeige die Versionen in der Paketquelle an; nimm die Version genau so, wie die Spalte sie nennt (eine Vorabversion wie 0.3.2-rc.1 steht als 0.3.2~rc.1 da).
apt list -a palaver-server
Installiere die vorige Version; palaverd startet neu.
sudo apt install palaver-server=0.3.0
Halte apt davon ab, es wieder zu aktualisieren.
sudo apt-mark hold palaver-server
Vor dem nächsten Update: gib es wieder frei.
sudo apt-mark unhold palaver-server
Updating a Palaver server
last changed
Prerequisite: server installed per the install guide
Without the apt repository, from the release files: the update guide (release files)
Placeholders in the commands:
| Placeholder | Replace with |
|---|---|
0.3.0 |
previous Palaver version as apt list -a palaver-server shows it; a pre-release with ~, e.g. 0.3.2~rc.1 (way back) |
2026-10-11 |
today's date (backup file names) |
chat.example.org |
your domain name (INSTALL.md blocks) |
<cert-name> |
certificate name, if it differs from the domain |
vi |
editor of your choice |
1. Release notes
- read: release notes of every version after the installed one
- apply: changes listed there (configuration files, nginx site, LiveKit version)
Show the installed version.
/opt/palaver/bin/palaverd version
2. Backup
Dump the database.
sudo -u palaver pg_dump -Fc palaver > palaver-2026-10-11.dump
Save the configuration.
sudo tar -czf palaver-etc-2026-10-11.tar.gz -C /opt/palaver etc
3. Update
Load the package lists.
sudo apt update
Install the new version; palaverd restarts.
sudo apt upgrade
Show the new version.
/opt/palaver/bin/palaverd version
4. LiveKit
Only for a newer LiveKit in the release notes. Show the installed version.
/opt/palaver/bin/livekit-server --version
Download and install: the install guide, step 7, without the configuration.
Restart LiveKit; calls in progress drop.
sudo systemctl restart livekit
5. Check
Run doctor; expected: no findings.
sudo -u palaver /opt/palaver/bin/palaverd -env /opt/palaver/etc/palaverd.env doctor
Open the web client and log in.
Once: servers installed by hand
- for: servers installed per the install guide (release files) or per INSTALL.md before the package
palaver-server - once, instead of step 3
Check that the package is not installed yet; expected: is not installed.
dpkg -s palaver-server
Stop and disable palaverd.
sudo systemctl disable --now palaverd
Destructive: remove the hand-written unit (/etc/systemd/system/palaverd.service).
sudo rm /etc/systemd/system/palaverd.service
sudo systemctl daemon-reload
Destructive: remove the hand-written web snippet, log rotation and journal settings (/etc/nginx/snippets/palaver-web.conf, /etc/logrotate.d/palaver, /etc/systemd/journald@palaver.conf).
sudo rm /etc/nginx/snippets/palaver-web.conf /etc/logrotate.d/palaver /etc/systemd/journald@palaver.conf
Destructive: remove palaverd and the web client (/opt/palaver/bin/palaverd, /opt/palaver/web).
sudo rm /opt/palaver/bin/palaverd
sudo rm -r /opt/palaver/web
Download the repository's key.
sudo install -d -m 755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/palaver.gpg https://palaver.social/apt/palaver.gpg
Open /etc/apt/sources.list.d/palaver.list in an editor.
sudo vi /etc/apt/sources.list.d/palaver.list
Content:
deb [arch=amd64 signed-by=/etc/apt/keyrings/palaver.gpg] https://palaver.social/apt stable main
Load the package lists.
sudo apt update
Install palaver-server.
sudo apt install palaver-server
Check and load nginx.
sudo nginx -t && sudo systemctl reload nginx
Enable and start palaverd.
sudo systemctl enable --now palaverd
Next: step 4.
Once: servers installed with install.sh
- for: servers set up with
install.sh(Palaver 0.2.x) - once, after Once: servers installed by hand
- leftovers: helper script, install log, nginx site without the web snippet
Show the certificate name.
sudo ls /etc/letsencrypt/live/
Keep the old nginx site outside nginx's directories.
sudo cp /etc/nginx/sites-available/palaver /root/nginx-palaver-2026-10-11.conf
Site /etc/nginx/sites-available/palaver: full site as in the install guide, step 8.
Certificate name differs from the domain: open /etc/nginx/sites-available/palaver in an editor.
sudo vi /etc/nginx/sites-available/palaver
Change:
ssl_certificate,ssl_certificate_key:/etc/letsencrypt/live/chat.example.org/→/etc/letsencrypt/live/<cert-name>/
Check and load it.
sudo nginx -t && sudo systemctl reload nginx
Destructive: remove the helper script (/usr/local/sbin/palaverctl).
sudo rm /usr/local/sbin/palaverctl
Destructive: remove the install log (/var/log/palaver-install.log).
sudo rm /var/log/palaver-install.log
Destructive: remove install.sh's certificate name file (/opt/palaver/etc/cert), if present.
sudo rm /opt/palaver/etc/cert
Back to the previous version
- for: new version does not work
- database changes are not undone; if needed: dump from step 2, as in the install guide, Restore
Show the versions in the repository; use the version column exactly (a pre-release such as 0.3.2-rc.1 is listed as 0.3.2~rc.1).
apt list -a palaver-server
Install the previous version; palaverd restarts.
sudo apt install palaver-server=0.3.0
Keep apt from upgrading it.
sudo apt-mark hold palaver-server
Before the next update: release it.
sudo apt-mark unhold palaver-server