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:
- Uygulama dosyaları
C:\Program Files\Edese\VisioAI\dizinine kopyalanır - Visual C++ Runtime ve .NET 9 Runtime yüklenir (eksikse)
- Windows Hizmetleri olarak
Edese.VisioAI.Apikaydedilir - 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:4300Setup 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.gz2. Paketi açın
sudo mkdir -p /opt/edese/visioai
sudo tar -xzf visioai-x.y.z-linux-x64.tar.gz -C /opt/edese/visioai3. İ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 visioai4. Durumu kontrol edin
sudo systemctl status visioaiActive: 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.logPort 4300 zaten kullanımda
# Hangi process port 4300'ü kullanıyor
sudo lsof -i :4300appsettings.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çınWindows’ta Docker Desktop yüklüyse servis otomatik olarak Docker soketine erişir. Ek yapılandırma gerekmez.