Installationshandbuch für den 3CX Transcription Engine Server

Einführung

Diese Anleitung erklärt die Installation und Konfiguration des 3CX Transcription Engine Servers für die Nutzung lokal oder in der Cloud.

Die 3CX Transcription Engine erweitert Ihr 3CX-Telefonsystem um KI-gestützte Transkription, Sprechererkennung und Transkriptanalyse. Sie kann lokal oder in der Cloud bereitgestellt werden und ist direkt in die Administrationskonsole integriert.

Hinweis: Verfügbar ab der AI Edition mit Version 16SC oder höher.

Über die Beispiele in diesem Dokument

In diesem Dokument wird example.com als 3CX-FQDN und wmr.3cx-example.com als FQDN des Transkriptionsgeräts verwendet; Sie müssen diese durch Ihre eigenen FQDNs ersetzen.

Anforderungen an den Maschinenhost

Hardware-Spezifikationen

• GPU: Mindestens empfohlen (schnell): Nvidia 24 GB RTX GPU
• CPU: Mindestens 4 vCPU, empfohlen: 6 vCPU
• RAM: Mindestens 24 GB
• Speicher: Mindestens 20 GB freier Speicherplatz
• On-Premise oder Cloud

BIOS-Einstellungen

• Secure Boot: Deaktiviert
• CSM: Deaktiviert
• Unterstützung für die Größenänderung der Leiste: Deaktiviert (erfordert möglicherweise einen doppelten Neustart)
• IOMMU: Aktiviert

Betriebssystem

• Betriebssystem: Debian 12 (Vollständig aktualisiert)

Firewall-Konfiguration

Öffnen Sie die folgenden TCP-Ports:

• TCP 61443 – nur von der PBX-IP aus zulassen
• TCP 80 – für die Erstellung/Verlängerung von Let’s Encrypt SSL-Zertifikaten, falls Sie keine benutzerdefinierten Zertifikate einrichten.

Konfigurieren Sie Ihr System

• Melden Sie sich per SSH an Ihrem Transkriptionsrechner an und wechseln Sie zum Root-Benutzer.
• Aktualisieren Sie Ihr System:

apt-get update

apt-get upgrade



• Erforderliche Voraussetzungen installieren:

apt -y install curl apt-transport-https gnupg gpg wget iptables-persistent build-essential dkms



• Um sicherzustellen, dass alle Systemaktualisierungen (insbesondere Kernel-Image-Upgrades) wirksam werden, starten Sie das System jetzt neu:

reboot



• Prüfen Sie, ob die NVIDIA-Treiber bereits installiert und ausgeführt werden:

nvidia-smi



• Wenn Sie die Fehlermeldung „Befehl nicht gefunden“ erhalten, müssen Sie die NVIDIA-Treiber installieren:

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

wget https://developer.download.nvidia.com/compute/cuda/repos/debian12/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, ob alles ordnungsgemäß funktioniert:

nvidia-smi



• …wodurch Ihnen der aktuelle Status der Maschine angezeigt wird:

user@wmr-3cx-example-com:~$ 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                                                             |

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

user@wmr-3cx-example-com:~$



Installationsbefehl ausführen

• Navigieren Sie in Ihrer 3CX-Administrationskonsole zu „Admin → Integrationen → Transkription“.
• Wählen Sie als Transkriptionsanbieter die 3CX-Transkriptions-Engine (lokal installiert) aus.
• Klicken Sie anschließend auf „Weiter“.

• Auf der Transkriptionsseite wird nun der Installationsbefehl angezeigt, der auf Ihrem Transkriptionsrechner ausgeführt werden muss. Klicken Sie auf die Schaltfläche „Kopieren“, um den Befehl in die Zwischenablage zu kopieren.
• Melden Sie sich per SSH an Ihrem Transkriptionsrechner an und wechseln Sie zum Root-Benutzer.
• Führen Sie den Installationsbefehl aus, beispielsweise wie im folgenden Beispiel:

source <(curl -s https://example.com/webmeeting/onboardai/99887766-aabb-1122-ccdd-abcdef123456)

Installationsassistent für Transkriptionen

Sie werden aufgefordert, zwischen der Verwendung von benutzerdefinierten SSL-Zertifikaten oder von mit Let's Encrypt generierten Zertifikaten zu wählen.

Verwendung benutzerdefinierter SSL-Zertifikate

• Legen Sie Ihre Zertifikatsdateien im PEM-Format in folgendes Verzeichnis: /opt/3cxwm/cert:

• server.crt muss Ihren öffentlichen Schlüssel (und gegebenenfalls Ihre Zertifikatskette) enthalten
• server.key muss Ihren privaten Schlüssel enthalten

• Stellen Sie sicher, dass die korrekten Berechtigungen für Ihre Zertifikatsdateien festgelegt sind:

sudo chown www-data:www-data /opt/3cxwm/cert/server.*

sudo chmod 600 /opt/3cxwm/cert/server.*

Zertifikate mit Certbot erstellen

So erstellen Sie Ihre eigenen Zertifikate mit Let's Encrypt Certbot:

• Melden Sie sich per SSH an Ihrem Transkriptionsrechner an und wechseln Sie zum Root-Benutzer.
• Führen Sie die folgenden Befehle aus:

sudo apt-get install certbot

sudo certbot certonly --standalone --preferred-challenges http -d wmr.3cx-example.com

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

Automatische Zertifikatserneuerung

So automatisieren Sie die Zertifikatserneuerung mit Let's Encrypt Certbot:

• Melden Sie sich per SSH an Ihrem Transkriptionsrechner an und wechseln Sie zum Root-Benutzer.
• Führen Sie den Befehl `nano /root/certupdate.sh` aus, um das Skript zu erstellen, und fügen Sie folgenden Inhalt hinzu:

#!/bin/bash

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

chown www-data:www-data /opt/3cxwm/cert/server.*

chmod 600 /opt/3cxwm/cert/server.*



• Das Skript ausführbar machen:

chmod +x /root/certupdate.sh



• Bearbeiten Sie die Crontab:

crontab -e



• Fügen Sie Folgendes zur Crontab hinzu:

0 3 * * * /root/certupdate.sh

3CX-Richtlinie für vollqualifizierte Domainnamen

Wenn Sie einen von 3CX bereitgestellten FQDN verwenden (z. B. bei der Installation über Option 1), beachten Sie Folgendes:

• Der FQDN wird gelöscht, wenn die Transkriptions-Engine aus der PBX-Benutzeroberfläche entfernt wird. Wenn Ihre PBX innerhalb von 30 Tagen keine Verbindung zu wmr.3cx.net herstellt, wird der FQDN automatisch gelöscht.

Überprüfen Sie die Verbindung zum Transkriptionsserver.

Um die Verbindung zwischen PBX und Transkriptionsserver zu überprüfen, können Sie folgenden Befehl auf der PBX ausführen:

[email protected]:~$ curl -w "n" https://wmr.3cx-example.com:61443/webmeeting

OK

[email protected]:~$



…was bei einer erfolgreichen Antwort „OK“ anzeigen sollte.

Sie können auch in der 3CX-Administrationskonsole zu „Admin → Integrationen → Transkription“ navigieren, um den Status Ihrer Transkriptions-Engine zu überprüfen.

Aktualisierungen des Transkriptionsservers

Geplant

Der Transkriptionsserver prüft und aktualisiert sich automatisch auf die neueste Version. Die automatische Aktualisierung wird jeden Sonntag um 1:00 Uhr (Serverzeit) ausgeführt.

Auf Anfrage

Wenn Sie vor dem geplanten Aktualisierungszeitraum auf die neueste Version aktualisieren möchten:

• Melden Sie sich per SSH an Ihrem Transkriptionsrechner an und wechseln Sie zum Root-Benutzer.
• Führen Sie die folgenden Befehle aus:

sudo apt update

sudo apt -y upgrade



Letztes Update

Dieses Dokument wurde zuletzt am 24. April 2026 aktualisiert

https://www.3cx.de/docs/transkriptions-engine-server/