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 oder alternativ Hyper-V unter Windows (dafür gibt es eine eigene Anleitung: FRANZFON unter Hyper-V installieren). Die Anlage selbst ist eine Debian-12-Installation mit Asterisk und der FRANZFON-Wizard-Software.
| Anforderung | Wert |
|---|---|
| Hypervisor | Proxmox VE 8.x (oder Hyper-V, siehe eigene Anleitung) |
| Arbeitsspeicher | mindestens 4 GB |
| Prozessorkerne | 2 vCPU |
| Prozessor-Befehlssatz | SSE4.2 (nur für die Voicemail-Transkription; Intel ab 2008, AMD ab 2011) |
| Festplatte | 32 GB |
| Netzwerk | bridged Interface mit DHCP oder fester IP |
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 direkt unter Windows ohne Hyper-V ist nicht vorgesehen. Die Anlage läuft als virtuelle Maschine unter Proxmox oder Hyper-V.
Video
Das Video FRANZFON Installation auf Proxmox zeigt alle Schritte dieser Anleitung einmal live, von der Registrierung bis zur verbundenen Anlage. Eingebettet findest du es im Schnellstart.
Schritt 1: VMA-Backup herunterladen
Das aktuelle VMA-Backup lädst du direkt auf deinen Proxmox-Host:
- Melde dich unter franzfon.de/portal an und öffne Downloads, Bereich FRANZFON TK-Anlage Proxmox.
- Öffne in der Proxmox-Weboberfläche deinen Node und dort den Reiter Shell.
- Kopiere den
wget-Befehl aus dem Portal, füge ihn in die Shell ein und drück Enter.
Die Datei landet in /var/lib/vz/dump/. Der Download dauert je nach Internetverbindung einen Moment.
Schritt 2: VM aus dem Backup wiederherstellen
- Öffne in Proxmox den Speicher local und dort Backups.
- Wähl die heruntergeladene Datei aus. Liegen mehrere da, erkennst du die aktuelle am Datum im Dateinamen.
- Klick auf Restore, wähl den Storage für die VM und vergib eine VM-ID. Proxmox schlägt die nächste freie Nummer vor.
- Klick auf Restore. Fertig ist es, wenn im Protokoll TASK OK steht.
Lieber auf der Kommandozeile? Dann geht es in der Shell des Proxmox-Hosts so:
qmrestore /var/lib/vz/dump/vzdump-qemu-NNN-DATUM.vma.zst <freie-VMID> --storage local-lvm
Schritt 3: VM-Konfiguration prüfen
Empfohlene Einstellungen für den produktiven Betrieb:
| Parameter | Wert |
|---|---|
cores | 2 |
memory | 4096 |
cpu | host (reicht den Befehlssatz SSE4.2 an die VM durch; nötig für die Spracherkennung) |
agent | 1 (QEMU Guest Agent aktiv) |
onboot | 1 (automatischer Start beim Proxmox-Boot) |
Den Guest Agent solltest du nach dem Restore ausdrücklich aktivieren, er wird beim Wiederherstellen nicht automatisch übernommen. Am schnellsten geht das in der Shell des Proxmox-Hosts:
qm set <VMID> --agent 1 --onboot 1 --cpu host
Schritt 4: VM starten
Wähl die neue VM in Proxmox aus und klick auf Start. Beim ersten Start läuft eine einmalige Initialisierung: Datenbank-Passwörter werden zufällig neu erzeugt, der Hostname gesetzt und Asterisk vorbereitet. Das dauert ein bis zwei Minuten.
In der Konsole der VM musst du dich nicht anmelden. Sie ist gesperrt, die ganze Einrichtung läuft über den Browser.
Schritt 5: IP-Adresse ermitteln
Die VM bezieht ihre IP-Adresse per DHCP. Am einfachsten findest du sie in deiner FritzBox: Öffne http://fritz.box, melde dich an und schau unter Heimnetz, Netzwerk nach dem Gerät mit FRANZFON im Namen.
Alternativ in der Shell des Proxmox-Hosts:
qm guest cmd <VMID> network-get-interfaces
Schritt 6: Einrichtung im Browser
Öffne im Browser die IP-Adresse mit Port 3000:
http://<IP-der-Anlage>:3000
Es startet direkt die Einrichtung. Im ersten Schritt Anschluss wählst du, wie die Anlage telefoniert:
- FRITZ!Box: Trag die Adresse deiner FritzBox ein (
fritz.boxoder ihre IP-Adresse, mit der IP klappt es am zuverlässigsten) und klick auf FritzBox suchen. Gib das Passwort der FritzBox ein und starte die Einrichtung. Bestätige sie an der FritzBox, per Tastendruck am Gerät oder mit dem Code aus deiner Authenticator-App. FRANZFON legt danach die Geräte in der FritzBox an. Zum Schluss wählst du die ausgehende Rufnummer, die kannst du später ändern. Details: FritzBox als SIP-Gateway einrichten. - SIP-Anbieter (Beta): Die Anlage meldet sich direkt bei deinem Anbieter an, siehe SIP-Anbieter (Beta) einrichten: easybell.
Schritt 7: Im Dashboard anmelden und mit dem Portal verbinden
- Klick auf Zum Dashboard und melde dich mit dem Standardzugang an. Benutzername und Passwort dafür stehen im Portal unter Downloads beim Proxmox-Download.
- Direkt nach der ersten Anmeldung vergibst du ein eigenes Passwort.
- Im Dashboard siehst du den Hinweis, dass die Anlage noch nicht mit dem Portal verknüpft ist. Klick darauf, füge deinen Lizenzschlüssel ein und speichere. Den Schlüssel findest du im Portal unter Lizenzen und in der E-Mail, die du nach der Registrierung bekommst.
Damit ist die Installation abgeschlossen. Wie es weitergeht, zeigt der Schnellstart ab Schritt 6.
Zuletzt aktualisiert: · Autor: IAP-IT, Viktor Weizel
Artikel hat nicht geholfen? Schreib uns.