İçeriğe geç
VidiStock

Kendi sunucunuza kurulum

VidiStock, verisinin dışarı çıkmasını istemeyen firmalar için kendi sunucunuza kurulabilir. Bulut sürümüyle aynı uygulamadır; tek firma için çalışır.

İki kurulum yolu vardır:

Yol Kimler için
Windows Server’a doğrudan kurulum Docker ve sanallaştırma kullanmayan firmalar. PostgreSQL ve Python kurulur; VidiStock tek bir Windows hizmeti olarak çalışır
Docker ile kurulum (bu sayfa) Linux sunucusu olan ya da Linux sanal makinesi açabilen firmalar

Windows kurulumu için size kurulum paketi (ZIP) ve ayrıntılı rehber iletilir; özet adımlar aşağıdadır.

Gereksinimler

Bölüm başlığı “Gereksinimler”
  • Docker ve Docker Compose kurulu bir Linux sunucu ya da Windows Server 2019 veya üstü
  • Sunucu donanımı:
En az Önerilen
İşlemci 4 çekirdek 8 çekirdek
Bellek 8 GB 16 GB
Disk 50 GB SSD 100 GB SSD ve yedekler için ayrı disk
Uygun olduğu büyüklük 10.000 seriye kadar 50.000 seriye kadar

Seri sayısı, ürün sayısı ile satışı ya da stoğu olan her ürün-depo çiftinin toplamıdır (2.000 ürün × 4 depo = 10.000 seri). Değerler yük testiyle ölçülmüştür: 3 yıllık satışla 5.500 seri yaklaşık 1,5 dakikada, 15.000 seri yaklaşık 5 dakikada tahmin edilir; uygulama en çok 3,5 GB bellek kullanır. Tahmin koşusu gece kendiliğinden çalışır.

  • Kullanıcıların sunucuya tarayıcıdan erişebilmesi
  • Docker kurulurken internet çıkışı (VidiStock’un kendisi internetsiz kurulur)

Kurulum

Bölüm başlığı “Kurulum”

Kurulum paketi (vidistock-linux-vX.Y.Z.tar.gz) uygulamanın hazır imajlarını içerir; sunucuda derleme yapılmaz. Paketi açıp imajları yükleyin, sonra deploy klasöründe:

Terminal window
sudo tar -xzf vidistock-linux-vX.Y.Z.tar.gz -C /opt/vidistock --strip-components=1
sudo docker load -i /opt/vidistock/images/vidistock-images.tar
cd /opt/vidistock/deploy
cp .env.onprem.example .env
# .env dosyasını düzenleyin
docker compose -f docker-compose.onprem.yml up -d

.env dosyasındaki değerler:

Değer Açıklama
POSTGRES_PASSWORD Veritabanı parolası
JWT_KEY En az 32 karakterlik rastgele bir anahtar
TENANT_NAME Firma adı
ADMIN_EMAIL, ADMIN_PASSWORD İlk yönetici hesabı
WEB_PORT Arayüzün yayınlanacağı port (varsayılan 80)
FORECAST_WORKERS Tahmin koşusunun aynı anda kullandığı çekirdek sayısı (varsayılan ve en az 4). 8 çekirdekten büyük sunucuda artırılabilir; ör. 16 çekirdekte 10–12

Firma ve yönetici hesabı ilk açılışta oluşturulur. Yeni firma kaydı kapalıdır.

Lisans

Bölüm başlığı “Lisans”

Kendi sunucunuzdaki kurulum, kurulduğu sunucuya bağlı ve süreli bir lisansla çalışır. Yeni kurulum lisanssız 15 gün çalışır; bu sürede etkinleştirilmelidir. Lisans durumu ve sunucunun makine kimliği uygulamada Ayarlar → Lisans bölümündedir.

Yol Nasıl
Çevrimiçi (sunucu app.vidistock.com adresine HTTPS ile çıkabiliyorsa) Kurulum anahtarını ayarlara yazın (aşağıda). Lisans açılışta ve her gün kendiliğinden eşitlenir; sözleşme yenilendiğinde yeni tarih kendiliğinden gelir. Beklemeden almak için Şimdi eşitle
İnternetsiz Makine kimliğini VidiStock’a iletin; size gönderilen lisans dosyasını (.vslic) Lisans dosyası yükle ile yükleyin. Süre dolmadan yeni dosya isteyin

Bitişe 15 gün kala yöneticiye uyarı gösterilir. Süre dolduktan sonra uygulama 15 gün daha çalışır ve herkese uyarı gösterir; ardından kapanır: giriş yapılır ama yalnızca Lisans ekranı açılır. Veri silinmez; lisans yenilenince uygulama kaldığı yerden devam eder.

Lisans ayrıca kullanıcı, aktif ürün ve depo sayısını ve ERP entegrasyonunu sınırlar. Eşitleme sırasında VidiStock’a yalnızca makine kimliği, uygulama sürümü ve bu üç sayı gider; ürün, satış ve stok verisi gitmez.

Lisans başka sunucuda çalışmaz. Sunucuyu değiştirecekseniz ya da işletim sistemini yeniden kuracaksanız önceden VidiStock’a haber verin; lisans yeni sunucuya aktarılır.

Kurulum anahtarı ve destek bağlantısı

Bölüm başlığı “Kurulum anahtarı ve destek bağlantısı”

Lisansın kendiliğinden eşitlenmesi ve uygulamadaki Destek sayfasının çalışması için VidiStock’un verdiği kurulum anahtarını .env dosyasına yazın ve kurulumu yeniden başlatın:

SUPPORT_CENTRAL_URL=https://app.vidistock.com
SUPPORT_INSTALLATION_KEY=vsi_...

Sunucunun yalnızca bu adrese HTTPS çıkışı olması yeterlidir; içeri doğru port açılmaz. Destek talebinde VidiStock’a yalnızca talep metni, ekler, talebi açanın adı ve e-postası ile uygulama sürümü gider. Anahtar girilmezse Destek sayfası e-posta adresini gösterir ve lisans dosyayla yüklenir.

Kullanıcıları e-postayla davet edebilmek için aynı dosyada APP_PUBLIC_URL (kullanıcıların uygulamayı açtığı adres) ve isteğe bağlı olarak EMAIL_* (SMTP) ayarlarını doldurun. SMTP boşsa davet bağlantısı ekranda gösterilir.

Güncelleme

Bölüm başlığı “Güncelleme”

Yeni sürüm uygulamanın Ayarlar → Güncelleme kartından kurulur; kartı yönetici rolündeki kullanıcılar görür. Kart yeni sürümü ve sürüm notlarını gösterir; Şimdi güncelle dendiğinde:

  1. Paket indirilir; VidiStock imzası ve dosyanın bütünlüğü denetlenir.
  2. Veritabanının yedeği alınır.
  3. Yeni sürüm kurulur; uygulama birkaç dakika kullanılamaz.
  4. Yeni sürüm açılmazsa önceki sürüme ve yedeğe kendiliğinden dönülür.

İsterseniz yeni sürümü gece kendiliğinden kur seçeneğini açın. Uygulamadan güncelleme için kurulum anahtarı girilmiş ve lisans geçerli olmalıdır; Ubuntu’da sunucuya bir kez güncelleyici kurulur (sudo bash /opt/vidistock/updater/install-updater.sh), Windows’ta kurulum betiği kurar.

İnternet çıkışı olmayan sunucuda güncelleme, size iletilen yeni paketle elle yapılır: önce yedek alın, paketi açıp imajları yükleyin ve aynı komutla yeniden başlatın. Veritabanı değişiklikleri açılışta kendiliğinden uygulanır.

Yedekleme

Bölüm başlığı “Yedekleme”

Tüm veri PostgreSQL’dedir (pgdata birimi). Düzenli olarak pg_dump ile yedek alın.

Windows Server’a doğrudan kurulum

Bölüm başlığı “Windows Server’a doğrudan kurulum”

Sanallaştırma gerekmez. Sunucuda PostgreSQL 17 ve Python 3.12 kurulu olmalıdır; .NET ve IIS gerekmez.

  1. Kurulum paketini (ZIP) bir klasöre açın.

  2. Yönetici olarak açılmış PowerShell’de:

    Terminal window
    Get-ChildItem -Recurse | Unblock-File
    Set-ExecutionPolicy -Scope Process Bypass -Force
    .\install.ps1 -TenantName "Firma Adı A.Ş." -AdminEmail "[email protected]"

  3. Günlük yedeği kurun: C:\VidiStock\scripts\backup.ps1 -Schedule

  4. Lisansı etkinleştirin (yukarıda, Lisans). Kurulum anahtarınız varsa betiğe -InstallationKey "vsi_..." olarak da verebilirsiniz; betik kurulumun sonunda makine kimliğini ve lisans durumunu yazdırır.

Betik veritabanı kullanıcısını oluşturur, uygulamayı C:\VidiStock altına kurar, “VidiStock” Windows hizmetini başlatır ve güvenlik duvarında portu açar. Güncellemek için yeni paketteki install.ps1 parametresiz çalıştırılır; ayarlar ve veri korunur. Port, HTTPS, yedekten geri yükleme ve sorun giderme için size iletilen rehbere bakın.

Unutulan parola

Bölüm başlığı “Unutulan parola”

Kullanıcılar parolalarını giriş ekranındaki Parolamı unuttum ile e-postayla yeniler; bunun için .env dosyasında e-posta (EMAIL_*) ve APP_PUBLIC_URL ayarları tanımlı olmalıdır. Tanımlı değilse parolayı firmanın yöneticisi Ayarlar → Kullanıcılar bölümünden yeniler.

Firmanın tek yöneticisi parolasını unuttuysa sunucuda şu komut geçici bir parola belirler ve ekrana yazar:

Terminal window
# Docker kurulumu (deploy klasöründe)
docker compose -f docker-compose.onprem.yml exec api dotnet VidiStock.Api.dll reset-password [email protected]
Terminal window
# Windows'a doğrudan kurulum (yönetici olarak açılmış PowerShell)
& 'C:\VidiStock\app\VidiStock.Api.exe' reset-password admin@firma.com

Geçici parolayla girdikten sonra kullanıcı menüsünden Parolamı değiştir ile yeni parola belirleyin.

ERP bağlayıcısı

Bölüm başlığı “ERP bağlayıcısı”

ERP entegrasyonu kullanacaksanız bağlayıcı aynı kurulumda netsis profiliyle hazırdır; ayrıntı için ERP entegrasyonu sayfasına bakın.