BaşlangıçKurulum

Kurulum

Bu kılavuzun sonunda VisioAI çalışır durumda olacak ve tarayıcıdan web arayüzüne erişebileceksiniz.

Ön Koşullar

Kuruluma başlamadan önce şunların hazır olduğundan emin olun:

  • Sistem Gereksinimleri sayfasındaki donanım ve yazılım gereksinimleri karşılanmış olmalı
  • Docker Engine kurulu ve çalışıyor olmalı
  • Makineye yönetici (root / Administrator) yetkisiyle erişebilmelisiniz
  • Edese lisans anahtarınız hazır olmalı
⚠️

GPU inference kullanacaksanız Docker kurulumundan önce NVIDIA sürücüsü (520+) ve NVIDIA Container Toolkit kurmanız gerekir. Sürücü kurulumu tamamlandıktan sonra makineyi yeniden başlatın.

Windows Kurulumu

1. Kurulum paketini indirin

Edese lisans portalından size gönderilen kurulum bağlantısını kullanarak VisioAI-Setup-x.y.z.exe dosyasını indirin.

2. Kurulum sihirbazını çalıştırın

Kurulum dosyasını yönetici olarak çalıştırın. Sihirbaz şu adımları gerçekleştirir:

  1. Uygulama dosyaları C:\Program Files\Edese\VisioAI\ dizinine kopyalanır
  2. Visual C++ Runtime ve .NET 9 Runtime yüklenir (eksikse)
  3. Windows Hizmetleri olarak Edese.VisioAI.Api kaydedilir
  4. Güvenlik duvarı kuralları eklenir (port 4300)

3. Kurulumu doğrulayın

Kurulum tamamlandıktan sonra tarayıcıda şu adresi açın:

http://localhost:4300

Setup Wizard ekranı görünüyorsa kurulum başarılıdır.

Linux Kurulumu

1. Kurulum paketini indirin

# Lisans portalındaki bağlantı ile indirin; örnek:
wget https://releases.edese.ai/visioai/x.y.z/visioai-x.y.z-linux-x64.tar.gz

2. Paketi açın

sudo mkdir -p /opt/edese/visioai
sudo tar -xzf visioai-x.y.z-linux-x64.tar.gz -C /opt/edese/visioai

3. İzinleri ve servisi ayarlayın

# Çalıştırma izni
sudo chmod +x /opt/edese/visioai/VisioAI
 
# Systemd servis dosyasını kopyalayın
sudo cp /opt/edese/visioai/scripts/visioai.service /etc/systemd/system/
 
# Servisi etkinleştirin ve başlatın
sudo systemctl daemon-reload
sudo systemctl enable visioai
sudo systemctl start visioai

4. Durumu kontrol edin

sudo systemctl status visioai

Active: active (running) görünüyorsa servis başarıyla çalışıyordur.

5. Kurulumu doğrulayın

curl http://localhost:4300/api/system/health

{"status":"Healthy"} yanıtı dönüyorsa kurulum tamamdır.

Kurulum Sonrası

Kurulum tamamlandıktan sonra İlk Yapılandırma kılavuzuna geçin. Setup Wizard sizi veritabanı seçimi, lisans doğrulama ve ilk kullanıcı oluşturma adımlarından geçirecek.

Sorun Giderme

Servis başlamıyor

# Log dosyasını inceleyin
sudo journalctl -u visioai -n 100
# veya
cat /opt/edese/visioai/logs/visioai-latest.log

Port 4300 zaten kullanımda

# Hangi process port 4300'ü kullanıyor
sudo lsof -i :4300

appsettings.json içinde Kestrel:Endpoints:Http:Url değerini farklı bir porta güncelleyin.

Docker bağlanamıyor

VisioAI’yı çalıştıran kullanıcının docker grubuna dahil olduğundan emin olun:

sudo usermod -aG docker $USER
# Oturumu kapatıp tekrar açın

Windows’ta Docker Desktop yüklüyse servis otomatik olarak Docker soketine erişir. Ek yapılandırma gerekmez.