3CX AI Server auf macOS oder Debian (mit NVIDIA) installieren

Einführung

Diese Anleitung erklärt die Installation des 3CX AI Servers für eine 3CX PBX ab Version 20 Update 10 auf einem unterstützten Apple Silicon Mac, z. B. einem Mac Mini. Der 3CX AI Server transkribiert PBX-Anrufe und führt Anrufanalysen durch.

Allgemeine Anforderungen

  • Sie benötigen Zugriff auf die 3CX-Administrationskonsole sowie Shell- oder Terminalzugriff auf dem Rechner (macOS oder Debian), auf dem der 3CX AI Server ausgeführt werden soll.
  • Sie benötigen lokale Administratorrechte (zur Ausführung mit sudo).
  • Stellen Sie sicher, dass der 3CX AI Server die Telefonanlage über ihren Haupt-SSL-Port (üblicherweise 443 oder 5001) und die 3CX-Downloadserver erreichen kann.
  • Falls die Option „3CX AI Server“ in der Telefonanlage nicht angezeigt wird, überprüfen Sie, ob Sie die korrekte 3CX-Version und -Lizenz verwenden, und prüfen Sie erneut unter „Admin“ > „Integrationen“ > „Transkription“ > „3CX AI Server“.

macOS-Anforderungen

  • Es werden ausschließlich Apple Silicon Macs unterstützt. Intel-basierte Macs werden nicht unterstützt.
  • Die Mindestspeicherkapazität beträgt 16 GB RAM. Empfohlen werden 24 GB RAM. Als praktischer Einstiegspunkt wird ein Mac Mini empfohlen.

Debian-Anforderungen

  • Verwenden Sie Debian 12 oder Debian 13 mit einer unterstützten NVIDIA-Grafikkarte, idealerweise mit vorinstallierten NVIDIA-Treibern und CUDA-Bibliotheken.
  • Die Mindestanforderungen an die Hardware sind 16 GB RAM, 20 GB freier Festplattenspeicher und 16 GB VRAM. Empfohlen werden 24 GB RAM und eine Grafikkarte der RTX-Klasse mit 24 GB VRAM.

Prüfen Sie, ob Ihr Mac geeignet ist

Verwenden Sie einen Apple Silicon Mac mit ausreichend freiem Speicherplatz und Arbeitsspeicher für die erwartete Transkriptions- und Analyselast.

uname -m ; system_profiler SPHardwareDataType | egrep 'Chip|Memory'

Ein positives Ergebnis zeigt die Apple Silicon-Hardware und die erwartete Speichergröße an. Zum Beispiel:

arm64

2026-07-10 16:35:56.134 system_profiler[2278:79797] hw.cpufamily: 0x17d5b93a

      Chip: Apple M4 Pro

      Memory: 24 GB

Wenn der Mac Intel-Hardware meldet, Apple Silicon nicht anzeigt oder zu wenig Speicher anzeigt, brechen Sie die Installation ab und verschieben Sie sie auf einen unterstützten Mac, anstatt die Installation auf nicht unterstützter Hardware zu erzwingen.

Vorbereitung Ihres Linux-Hosts

Aktualisieren Sie das Betriebssystem.

Führen Sie vor der Installation des 3CX AI Servers ein Paketupdate und -upgrade durch:

sudo apt-get update

sudo apt-get upgrade

Starten Sie die Maschine neu, um sicherzustellen, dass der laufende Kernel und die installierten Header übereinstimmen:

sudo reboot

Installieren Sie die Basiswerkzeuge

Installieren Sie die vom Installationsprogramm benötigten Pakete:

sudo apt -y install curl apt-transport-https gnupg gpg wget

Prüfen Sie, ob die Nvidia-Treiber und CUDA installiert sind:

nvidia-smi

 

Wenn die Treiber korrekt installiert sind, erhalten Sie eine Ausgabe ähnlich der folgenden:

user@aiserver:~$ nvidia-smi

Mon Jan 26 09:04:40 2026      

+-----------------------------------------------------------------------------------------+

| NVIDIA-SMI 590.48.01              Driver Version: 590.48.01      CUDA Version: 13.1     |

+-----------------------------------------+------------------------+----------------------+

| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |

| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |

|                                         |                        |               MIG M. |

|=========================================+========================+======================|

|   0  NVIDIA L4                      On  |   00000000:00:03.0 Off |                    0 |

| N/A   40C    P8             12W /   72W |       0MiB /  23034MiB |      0%      Default |

|                                         |                        |                  N/A |

+-----------------------------------------+------------------------+----------------------+

+-----------------------------------------------------------------------------------------+

| Processes:                                                                              |

|  GPU   GI   CI              PID   Type   Process name                        GPU Memory |

|        ID   ID                                                               Usage      |

|=========================================================================================|

|  No running processes found                                                             |

+-----------------------------------------------------------------------------------------+

Falls die Ausgabe von nvidia-smi nicht korrekt ist, wechseln Sie zum Root-Benutzer und stellen Sie sicher, dass nvidia-smi mit den erforderlichen Abhängigkeiten installiert ist:

apt -y install linux-headers-$(uname -r)

DEB_VERSION=$(VERSION_ID=; . /etc/os-release; echo "$VERSION_ID")

wget "https://developer.download.nvidia.com/compute/cuda/repos/debian${DEB_VERSION}/x86_64/cuda-keyring_1.1-1_all.deb"

dpkg -i cuda-keyring_1.1-1_all.deb

apt update

apt -y install nvidia-open

apt -y install nvidia-driver-cuda nvidia-kernel-open-dkms

reboot

Überprüfen Sie nach dem Neustart mit nvidia-smi, ob der Stack erfolgreich läuft.

Installation des 3CX AI-Servers

PBX-Seite

  • Gehen Sie in der Telefonanlage zu „Admin“ > „Integrationen“ > „Transkription“. Wählen Sie im Dropdown-Menü „3CX AI Server“ aus und klicken Sie auf die Schaltfläche „+ Add AI Server“. Kopieren Sie den generierten Installationsbefehl mithilfe der bereitgestellten Kopierschaltfläche.

Installation

KI-Serverseitig

curl -fsSL https://wmr-cdn.3cx.net/templates/install.sh | sudo bash -s -- mypbx.example.com 22334455-6677-8899-aabb-ccddeeff0011

  • Fügen Sie in Ihrem Terminal den zuvor von der PBX kopierten Befehl ein und führen Sie ihn aus.
  • Auf Debian:

3CX Serverseitige Installation

  • Wenn Sie eine GPU der Enterprise-Klasse wie eine Nvidia L4 mit 22 GB RAM bei einem Cloud-Anbieter verwenden, werden Sie möglicherweise gefragt, ob Sie ECC auf der GPU deaktivieren möchten. Wenn Sie dies bestätigen (geben Sie „y“ ein), wird ECC deaktiviert und somit 2 GB Speicher freigegeben, die sonst ungenutzt blieben. Beachten Sie, dass die Deaktivierung von ECC einen sofortigen Neustart auslöst und Sie nach dem Neustart zum ersten Schritt zurückkehren müssen.

Mac: Mit Installation fortfahrenLinux: Mit Installation fortfahren

  • Der Installer fragt Sie anschließend, ob Sie die Installation durchführen möchten und ob Sie den Nutzungsbedingungen zustimmen; bestätigen Sie, um fortzufahren:

Installationsfortschritt

  • Das Installationsprogramm lädt die erforderlichen Komponenten herunter, erstellt die Konfiguration, installiert die Dienste und registriert den KI-Server an der Telefonanlage.

Prüfen Sie, ob der 3CX AI-Server funktioniert.

KI Server Status

  • Kehren Sie zu Admin > Integrationen > Transkription zurück und vergewissern Sie sich, dass der neue KI-Serverstatus grün und nicht rot angezeigt wird.

Warteschleifen- und Aktivitätsinformationen

  • Sie können einige Testanrufe durchführen, um die korrekte Funktionalität zu bestätigen; während der Verarbeitung der Aufzeichnungen werden in der Admin-Konsole Warteschleifen- und Aktivitätsinformationen angezeigt.

Mehrere Telefonanlagen nutzen denselben KI-Server

Mehrere Telefonanlagen nutzen denselben KI-Server

Sie können auch mehreren Telefonanlagen die Nutzung desselben KI-Servers erlauben. Folgen Sie dazu einfach erneut der obigen Installationsanleitung für die neue Telefonanlage.

Beispielsweise müssten Sie in der neuen Telefonanlage unter „Integrationen“ > „Transkription“ auf „KI-Server hinzufügen“ klicken, dann Ihren KI-Server auswählen, den Befehl einfügen und die Eingabetaste drücken. Da der KI-Server bereits auf dem Host installiert ist, werden bereits installierte Komponenten übersprungen. Dadurch wird die neue Telefonanlage für die Nutzung des KI-Servers autorisiert.

Verwaltung des 3CX KI-Servers

Der 3CX AI Server installiert mehrere Dienste, darunter den Konverter, den Transkriptionsprozess und den Ollama-Dienst.

Verwaltung von macOS 3CX AI-Diensten

Verwenden Sie launchctl, um mit den installierten macOS-Diensten zu interagieren.

Dienste einstellen (und abmelden):

sudo launchctl bootout system/com.3cx.converter

sudo launchctl bootout system/com.3cx.transcriber

sudo launchctl bootout system/com.3cx.logrotate

sudo launchctl bootout system/com.ollama.serve

Starten (und registrieren) Sie die Dienste:

sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.converter.plist

sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.transcriber.plist

sudo launchctl bootstrap system /Library/LaunchDaemons/com.3cx.logrotate.plist

sudo launchctl bootstrap system /Library/LaunchDaemons/com.ollama.serve.plist

Verwaltung von Debian 3CX KI-Diensten

Verwenden Sie die folgenden Befehle, um den Betriebsstatus der 3CX-Dienste zu verwalten:

Servicestatus prüfen:

sudo systemctl status 3cxai-converter 3cxai-transcriber 3cxai-ollama

Starten Sie die Dienste neu:

sudo systemctl restart 3cxai-converter 3cxai-transcriber 3cxai-ollama

Stoppen Sie die Dienste:

sudo systemctl stop 3cxai-converter 3cxai-transcriber 3cxai-ollama

Starten Sie die Dienste:

sudo systemctl start 3cxai-converter 3cxai-transcriber 3cxai-ollama

Deinstallieren des KI-Servers.

Um das AI Server-Paket vom Host zu entfernen, führen Sie das mitgelieferte Deinstallationsskript aus dem Setup-Verzeichnis aus:

sudo /opt/3cx/aiserver/setup/3cxai-uninstall.sh

Verwaltung verbundener Telefonanlagen

Zur Verwaltung angeschlossener Telefonanlagen können Sie das integrierte Verbindungsmanager-Skript verwenden. Damit können Sie gespeicherte Berechtigungen für Telefonanlagen einsehen, deaktivieren, wieder aktivieren oder löschen.

Zeigen Sie zuerst die integrierte Hilfe an.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --help

Identifizieren und listen Sie alle konfigurierten PBX-Verbindungen auf und sehen Sie sich deren UUID an.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh

Eine PBX-Verbindung deaktivieren, ohne sie zu löschen.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --disable <UUID>

Eine zuvor deaktivierte PBX-Verbindung wieder aktivieren.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --enable <UUID>

Eine gespeicherte PBX-Verbindung endgültig löschen.

sudo /opt/3cx/aiserver/setup/3cxai-connection-manager.sh --delete <UUID>

Fehlerbehebung

Die verschiedenen PBX-Autorisierungen, Konfigurationen und sonstigen AI-Servereinstellungen werden alle in den folgenden Dateien gespeichert:

/opt/3cx/aiserver/setup/connections.json

/opt/3cx/aiserver/setup/config.json

Sie können Serverprobleme beheben, indem Sie die Serverprotokolle unter dem unten angegebenen Pfad überprüfen.

/var/opt/3cx/aiserver/logs

Das AI Server-Paket wird in diese Hauptpfade installiert.

/opt/3cx/aiserver

/var/opt/3cx/aiserver

  • Der KI-Server ist ausgefallen: Stellen Sie sicher, dass die Dienste geladen sind und der 3CX KI-Server die Telefonanlage über HTTPS erreichen kann.
  • Der Installationsbefehl funktioniert nicht: Verwenden Sie keinen Installationsbefehl aus einer vorherigen Konfiguration. Löschen Sie den Eintrag für den 3CX KI-Server in der Telefonanlage, erstellen Sie einen neuen Eintrag und installieren Sie ihn mit dem Installationsbefehl für diesen neuen Eintrag.
  • nvidia-smi schlägt fehl (nur Debian): Beheben Sie den Fehler im NVIDIA-Treiber oder CUDA-Status, bevor Sie das Installationsprogramm erneut ausführen.
  • Die Telefonanlage lehnt die Verbindung ab: Entfernen Sie die veraltete Konfiguration und installieren Sie den Server mit einem neuen, UUID-basierten Befehl.

Siehe auch

Letztes Update

Dieses Dokument wurde zuletzt am 3. August 2026 aktualisiert.

https://www.3cx.de/docs/installing-ai-server-macos-debian/