FRANZFON installieren

Schritt-für-Schritt-Anleitung zur Installation der FRANZFON-TK-Anlage als virtuelle Maschine auf einem Proxmox-Host.

Videoanleitung

Die komplette Installation einmal gezeigt - vom Download der VMA-Datei bis zum ersten Login im Wizard. Rund sechs Minuten.

Voraussetzungen

FRANZFON wird als fertige virtuelle Maschine ausgeliefert und benötigt einen laufenden Proxmox-VE-Host. Die Anlage selbst ist eine Debian-12-Installation mit Asterisk und der FRANZFON-Wizard-Software.

Eine direkte Installation auf einem Raspberry Pi, in Docker oder unter Windows ist nicht vorgesehen. Die Anlage muss als Proxmox-VM betrieben werden.

Schritt 1: VMA-Backup herunterladen

Lade die aktuelle VMA-Datei aus dem öffentlichen Update-Verzeichnis herunter:

https://franzfon.de/updates/proxmox/

Suche nach der jüngsten Datei im Format vzdump-qemu-NNN-YYYY_MM_DD-HH_MM_SS.vma.zst und lade sie auf deinen Proxmox-Host (zum Beispiel via SCP nach /var/lib/vz/dump/).

Schritt 2: VM aus dem Backup wiederherstellen

Auf dem Proxmox-Host per SSH einloggen und die VMA wiederherstellen:

qmrestore /var/lib/vz/dump/vzdump-qemu-NNN-DATUM.vma.zst <freie-VMID> --storage local-lvm

Ersetze <freie-VMID> durch eine bisher nicht vergebene Zahl, zum Beispiel 120.

Schritt 3: VM-Konfiguration prüfen

Nach dem Restore prüfe die Standardwerte:

qm config <VMID>

Empfohlene Einstellungen für den produktiven Betrieb:

Den Guest Agent solltest du nach dem Restore ausdrücklich aktivieren - er wird beim Klonen einer VMA nicht automatisch übernommen:

qm set <VMID> --agent 1 --onboot 1

Schritt 4: VM starten

qm start <VMID>

Beim ersten Start läuft eine einmalige Initialisierung: Datenbank-Passwörter werden zufällig neu erzeugt, Hostname gesetzt, Asterisk-Konfiguration vorbereitet. Das dauert ein bis zwei Minuten.

Schritt 5: IP-Adresse ermitteln

Die VM bezieht per Standardeinstellung eine IP-Adresse via DHCP. Du findest sie über die Proxmox-Konsole (Login-Banner) oder per:

qm guest cmd <VMID> network-get-interfaces

Notiere dir die IPv4-Adresse - sie ist die Erreichbarkeit der Anlage im Netzwerk.

Schritt 6: Web-Wizard aufrufen

Öffne im Browser die IP-Adresse mit Port 3000:

http://<IP-der-Anlage>:3000

Beim ersten Aufruf erscheint der Setup-Wizard. Logge dich mit dem Standardzugang ein, der auf der Proxmox-Konsole nach dem Boot angezeigt wird. Direkt nach dem ersten Login wirst du aufgefordert, das Passwort zu ändern.

Was als Nächstes kommt

Nach dem Setup führt der Wizard durch die FritzBox-Anbindung. Eine detaillierte Anleitung dazu findest du im Artikel zur FritzBox-Einrichtung.

Zuletzt aktualisiert: 15. April 2026 · Autor: IAP-IT, Viktor Weizel