macOS veya Debian’da (NVIDIA ile) 3CX AI Sunucusu…

Giriş

Bu kılavuz, Mac Mini gibi desteklenen bir Apple Silicon Mac üzerinde, 3CX PBX Sürüm 20 Güncelleme 10 ve üzeri için 3CX AI Sunucusunun nasıl kurulacağını açıklamaktadır. 3CX AI Sunucusu, PBX aramalarını metne dönüştürecek ve arama analizi gerçekleştirecektir.

Genel Gereksinimler

  • 3CX AI Sunucusunu çalıştıracak makineye (macOS veya Debian) 3CX Yönetici Konsolu erişimi ve kabuk ya da terminal erişimi sağlamanız gerekir.
  • Yerel yönetici haklarına ihtiyacınız olacaktır (sudo ile yetki yükseltmek için).
  • 3CX AI Sunucusunun, ana SSL portu üzerinden (genellikle 443 veya 5001) PBX'e ve 3CX indirme sunucularına erişebildiğinden emin olun.
  • PBX'te 3CX AI Sunucusu seçeneği görünmüyorsa, doğru 3CX Sürümünü ve 3CX lisansını kullandığınızı doğrulayın ve Yönetici > Entegrasyonlar > Transkripsiyon > 3CX AI Sunucusu altında tekrar kontrol edin.

macOS Gereksinimleri

  • Yalnızca Apple Silicon tabanlı Mac’ler desteklenmektedir. Intel tabanlı Mac’ler desteklenmemektedir.
  • Minimum bellek kapasitesi 16 GB RAM’dir. Önerilen hedef 24 GB RAM’dir ve Mac Mini sınıfı donanım, pratik olarak uygulanması beklenen başlangıç yoludur.

Debian Gereksinimleri

  • Desteklenen bir NVIDIA GPU’ya sahip Debian 12 veya Debian 13 kullanın; tercihen önceden yüklenmiş NVIDIA sürücüleri ve CUDA kütüphaneleri bulunan bir sürüm olsun.
  • Asgari donanım gereksinimleri 16 GB RAM, 20 GB boş disk alanı ve 16 GB VRAM’dir. Önerilen hedef ise 24 GB RAM ve 24 GB kapasiteli bir RTX sınıfı GPU’dur.

Mac’inizin uygunluğunu doğrulayın

Beklenen transkripsiyon ve analiz yükü için yeterli boş disk alanı ve belleğe sahip bir Apple Silicon Mac kullanın.

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

Sağlıklı bir sonuç, Apple Silicon donanımını ve beklenen bellek boyutunu gösterecektir. Örneğin:

arm64

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

      Chip: Apple M4 Pro

      Memory: 24 GB

Eğer Mac, Intel donanımı algılarsa, Apple Silicon'u tanımazsa veya bellek miktarı çok az görünüyorsa, kurulumu durdurun ve desteklenmeyen bir donanıma zorla yüklemek yerine, kurulumu desteklenen bir Mac'e taşıyın.

Linux Sunucunuzu Hazırlama

İşletim sistemini güncelleyin

3CX AI Sunucusunu kurmadan önce paket güncellemesi ve yükseltmesi gerçekleştirin:

sudo apt-get update

sudo apt-get upgrade

Çalışan çekirdek ile yüklü başlık dosyalarının birbiriyle uyumlu olduğundan emin olmak için sistemi yeniden başlatın:

sudo reboot

Temel araçları kurun

Yükleyici tarafından gerekli görülen paketleri yükleyin:

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

Nvidia sürücülerinin ve CUDA'nın kurulu olup olmadığını kontrol edin:

nvidia-smi

 

Sürücüler doğru şekilde yüklenmişse, aşağıdakine benzer bir çıktı alırsınız:

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                                                             |

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

Nvidia-smi’nin doğru çıktısını göremiyorsanız, root kullanıcısına geçiş yapın ve nvidia-smi'nin gerekli bağımlılıklarla birlikte yüklü olduğundan emin olun:

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

Sistemi yeniden başlattıktan sonra, nvidia-smi ile yığının sorunsuz çalıştığını doğrulayın.

3CX AI Sunucusu Kurma

PBX Side

  • In the PBX, go to Admin > Integrations > Transcription.
  • From the dropdown, select 3CX AI Server and click the + Add AI Server button.
  • Copy the generated installation command using the provided copy button.

AI Sunucu Tarafı

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

  • Terminal’de önceden PBX’ten kopyalanan komutu yapıştırıp çalıştırın.
  • Debian’da:

  • 22 GB belleğe sahip bir bulut sağlayıcısında Nvidia L4 gibi kurumsal düzeyde bir GPU kullanıyorsanız, GPU’daki ECC’yi devre dışı bırakmak isteyip istemediğiniz sorulabilir. Kabul ederseniz (“y” yazarsanız), bu işlem ECC’yi devre dışı bırakacak ve böylece aksi takdirde kullanılmayacak olan 2 GB bellek geri kazanılacaktır. ECC’yi devre dışı bırakmanın hemen bir yeniden başlatma işlemini tetikleyeceğini ve yeniden başlatmanın ardından ilk adıma geri dönmeniz gerekeceğini unutmayın.

  • Ardından yükleyici, programı yüklemek isteyip istemediğinizi ve kullanım koşullarını kabul edip etmediğinizi soracaktır; devam etmek için kabul edin:

  • Yükleyici, gerekli bileşenleri indirir, yapılandırmayı oluşturur, hizmetleri yükler ve AI Sunucusunu PBX’e kaydeder.

3CX AI Sunucusunun çalıştığını doğrulayın

  • Yönetici > Entegrasyonlar > Transkripsiyon‘a geri dönün ve yeni AI Sunucusu durumunun kırmızı değil, yeşil olarak göründüğünü doğrulayın.

  • Doğru çalıştığını doğrulamak için birkaç deneme araması yapabilirsiniz; kayıtlar işlenirken, Yönetici Konsolu kuyruk ve etkinlik bilgilerini gösterecektir.

Aynı AI Sunucusunu kullanan çoklu PBX

Aynı AI sunucusunun birden fazla PBX tarafından kullanılmasına da izin verebilirsiniz. Bunun için yeni PBX için yukarıdaki kurulum kılavuzunu tekrar uygulamanız yeterlidir.

Örneğin, yeni PBX'te Entegrasyonlar > Transkripsiyon‘a gidip “AI Sunucusu Ekle”ye tıklamanız, ardından AI sunucunuza gidip komutu yapıştırıp Enter tuşuna basmanız gerekir. AI sunucusu o ana bilgisayara zaten kurulmuş olduğundan, kurulum işlemi önceden kurulmuş bileşenleri atlayacaktır; bu sayede yeni PBX'in de AI sunucusunu kullanmasına izin verilmiş olur.

3CX AI Sunucu Yönetimi

3CX AI Sunucusu, dönüştürücü, transkripsiyon aracı ve Ollama hizmeti dahil olmak üzere çeşitli hizmetleri yükler.

macOS 3CX AI Hizmetlerinin Yönetimi

Yüklü macOS hizmetleriyle etkileşim kurmak için launchctl komutunu kullanın.

Hizmetleri durdurun (ve kayıtlarını silin):

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

Hizmetleri başlatın (ve kaydedin):

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

Debian 3CX AI Hizmetlerinin Yönetimi

3CX hizmetlerinin çalışma durumunu yönetmek için aşağıdaki komutları kullanın:

Hizmet durumunu kontrol edin:

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

Hizmetleri yeniden başlatın:

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

Hizmetleri durdurun:

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

Hizmetleri başlatın:

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

AI Sunucusunu kaldırma

AI Sunucu paketini ana bilgisayardan kaldırmak için, kurulum dizininde bulunan paketle birlikte gelen kaldırma komut dosyasını çalıştırın:

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

Bağlı PBX’lerin Yönetimi

Bağlı PBX’leri yönetmek için yerleşik bağlantı yöneticisi komut dosyasını kullanabilirsiniz. Bu komut dosyası sayesinde kayıtlı PBX yetkilendirmelerini inceleyebilir, devre dışı bırakabilir, yeniden etkinleştirebilir veya silebilirsiniz.

Önce yerleşik yardımı gösterin

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

Yapılandırılmış tüm PBX bağlantılarını belirleyin, listeleyin ve bunların UUID’lerini görüntüleyin

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

Bir PBX bağlantısını silmeden devre dışı bırakın.

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

Daha önce devre dışı bırakılmış bir PBX bağlantısını yeniden etkinleştirin.

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

Kaydedilmiş bir PBX bağlantısını kalıcı olarak silin.

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

Sorun Giderme

Çeşitli PBX yetkilendirmeleri, yapılandırmaları ve diğer AI sunucu ayarlarının tümü aşağıdaki dosyalarda kaydedilir:

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

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

Aşağıdaki yol altında bulunan sunucu günlüklerini kontrol ederek sunucudaki sorunları giderebilirsiniz.

/var/opt/3cx/aiserver/logs

AI Sunucu paketi şu ana yollara kurulur.

/opt/3cx/aiserver

/var/opt/3cx/aiserver

  • AI Sunucusu çalışmıyor: Hizmetlerin yüklü olduğunu ve 3CX AI Sunucusunun HTTPS üzerinden PBX’e erişebildiğini doğrulayın.
  • Yükleme komutu çalışmıyor - Önceki bir yapılandırmadan alınan yükleme komutunu kullanmaktan kaçının; PBX’ten 3CX AI Sunucusu girişini silin, yeni bir giriş oluşturun ve yeni oluşturulan 3CX AI Sunucusu girişi için yükleme komutunu kullanarak yüklemeyi gerçekleştirin.
  • nvidia-smi başarısız oluyor (yalnızca Debian): Yükleyiciyi yeniden çalıştırmadan önce NVIDIA sürücüsünü veya CUDA durumunu düzeltin.
  • PBX bağlantıyı reddediyor: Geçerliliğini yitirmiş yapılandırmayı kaldırın ve yeni bir UUID destekli komut kullanarak yeniden yükleyin.

Ayrıca Bakınız

Son Güncelleme

Bu belge en son 5 AĞustos 2026’da güncellendi.

https://www.3cx.com.tr/kullanici-kilavuzu/installing-ai-server-macos-debian/