FRANZFON installieren

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

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.

Die automatische Umwandlung von Voicemails in Text (Spracherkennung) benötigt den Prozessor-Befehlssatz SSE4.2. Fehlt er, läuft FRANZFON ganz normal weiter, nur diese eine Funktion bleibt deaktiviert. Läuft die VM mit einem allgemeinen CPU-Typ (zum Beispiel „kvm64”), stelle den CPU-Typ in Proxmox auf „host”, damit der Befehlssatz an die VM durchgereicht wird. Den schnelleren Befehlssatz AVX nutzt die Spracherkennung, wenn er vorhanden ist, er ist aber nicht Voraussetzung.

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 --cpu host

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: 03. Juni 2026 · Autor: IAP-IT, Viktor Weizel