KERNOVIQ bir Windows sunucuda ya da bilgisayarda, Linux için Windows Alt Sistemi'nde (WSL 2) kendine ait bir Linux dağıtımında çalışır. Kurulum sihirbazı her şeyi yerine koyar; ağdaki kullanıcılar KERNOVIQ'e, bir Linux sunucuya ulaşır gibi, bu bilgisayar üzerinden HTTPS ile ulaşır. Ürün, verisi ve yedekleri Linux'takiyle aynıdır (kurulum.md, kapali-ag-kurulumu.md).
İngilizcesi: KERNOVIQ on Windows.
kullanıcı tarayıcıları ──HTTPS :443──▶ Windows: KernoviqProxy hizmeti (Caddy)
│ 127.0.0.1:8280 (WSL localhost yönlendirmesi)
▼
WSL 2: "KERNOVIQ" dağıtımı (Ubuntu 24.04, systemd)
Docker Engine ─ KERNOVIQ (web, API, işçiler, PostgreSQL, Valkey)
1. Gereksinimler
| En az | Önerilen | |
|---|---|---|
| Windows | Windows 10 22H2, Windows 11, Windows Server 2022 ya da 2025; 64 bit (x64) | Windows Server 2025 |
| Bellek | 6 GB | 8 GB ve üstü |
| Disk | veri klasörünün sürücüsünde 20 GB boş alan | 40 GB ve üstü, artı yedekler için yer |
| İşlemci | donanım sanallaştırması açık (Intel VT-x / AMD-V; sanal makinede iç içe sanallaştırma) | 4 çekirdek |
| Ağ | kullanıcı ağlarından erişilebilen TCP 443 (yönlendirme için 80); kullanıcılar bu bilgisayarın DNS adını ya da IP adresini açar | kullanıcıların çözebildiği, bu bilgisayarı gösteren bir DNS adı |
| İnternet | kurulumda ve yükseltmelerde: Microsoft (WSL), Ubuntu arşivi, KERNOVIQ sitesi ve imaj kayıt defteri |
Desteklenmez: Windows Server 2019 ve öncesi, 32 bit ya da Arm Windows, etki alanı denetleyicileri (üye sunucuya kurun). Kurulum için yönetici hesabı gerekir.
2. Kurulum
KERNOVIQ-Setup.exedosyasını KERNOVIQ sitesinden indirin. Çalıştırmadan önce Özellikler → Dijital İmzalar sekmesine bakın: imzalayan KERNOVIQ yayıncısıdır. Her kurulum programının SHA-256 değeri sürümün imzalıSHA256SUMSdosyasındadır (releases/<sürüm>/).- Yönetici olarak çalıştırın ve lisans sözleşmesini kabul edin.
- Kurulum ayarları:
- Tam sürüm (önerilen): lisans e-postasındaki anahtarı (
KQL1…) içeren lisans dosyasını seçin; kurulum tam sürümü bu anahtarla lisans sunucusundan indirir ve lisansı etkinleştirir. - Deneme sürümü: lisanssız (deneme sürümü). Sonradan Ayarlar → Lisans'ta girilen anahtar kurulumu yerinde tam sürüme geçirir.
- İki durumda da ağdaki kullanıcılar HTTPS ile, sunucu adıyla
(varsayılan: bu bilgisayarın DNS adı) ya da bu bilgisayarın IP adresiyle
(
https://192.168.1.20) bağlanır. KERNOVIQ'i yalnızca bu bilgisayara bırakmak için (http://127.0.0.1:8280, başka kimse bağlanamaz) komut satırındankernoviq install --localile kurun. - Kuruluşumun sertifikasını kullan: kurumunuzun CA'sından (ör. AD CS) PEM biçiminde bir sertifika ve özel anahtarı. Seçilmezse kurulum bir iç sertifika otoritesi (iç CA) oluşturur.
- Veri klasörü: dağıtımın sanal diskinin büyüdüğü yer (varsayılan
C:\ProgramData\KERNOVIQ\wsl; yerel bir NTFS sürücü).
- Tam sürüm (önerilen): lisans e-postasındaki anahtarı (
- Gerekirse kurulum WSL'yi açar. Bunun için Windows'un yeniden başlaması gerekiyorsa sihirbaz söyler; yeniden başlattıktan sonra aynı hesapla oturum açın, kurulum bir pencerede kendiliğinden devam eder.
- İlk kurulum 10–20 dakika sürer (Ubuntu, Docker Engine ve KERNOVIQ imajları
indirilir). Sonunda sihirbaz şunları gösterir:
- adres, ör.
https://kernoviq.kurum.local; - kurumu ve ilk yöneticiyi tarayıcıda oluşturmak için tek kullanımlık
bağlantı; kullanılana kadar kimseyle paylaşmayın, sonra devreden
çıkarın:
kernoviq ctl config set SETUP_TOKEN=vekernoviq restart(kernoviq statuso tanımlı kaldıkça hatırlatır); - iç CA ile: kullanıcı bilgisayarlarının güvenmesi gereken
C:\ProgramData\KERNOVIQ\kernoviq-ca.crt(bölüm 4); - yedek anahtarı
C:\ProgramData\KERNOVIQ\keys\backup.key: bu bilgisayarın dışında güvenli bir yere kopyalayın; o olmadan yedekler geri yüklenemez.
- adres, ör.
Başlat menüsüne adrese giden bir KERNOVIQ kısayolu eklenir; kernoviq
komutu her yeni yönetici komut isteminde ya da PowerShell penceresinde çalışır.
Gözetimsiz kurulum
KERNOVIQ-Setup-<sürüm>.exe /S /ACCEPT_EULA /SERVERNAME=kernoviq.kurum.local /LICENSEKEYFILE=C:\lisans.txt
| Seçenek | |
|---|---|
/S |
sessiz (büyük harf, tek başına) |
/ACCEPT_EULA |
/S ile zorunlu: Son Kullanıcı Lisans Sözleşmesi'ni kabul edersiniz |
/EDITION=full ya da demo |
tam sürüm (varsayılan) ya da deneme; ikisi de ağa hizmet verir |
/SERVERNAME=ad |
kullanıcıların tarayıcıya yazacağı DNS adı (IP adresi de olur) |
/LICENSEKEYFILE=dosya |
lisans anahtarı (tam sürüm için zorunlu) |
/CERT=dosya /KEY=dosya [/CA=dosya] |
kurumunuzun sertifikası (PEM) |
/DATADIR=klasör |
veri klasörü |
Çıkış kodları: 0 kuruldu, 3010 Windows yeniden başlamalı (kurulum aynı
yöneticinin bir sonraki oturumunda devam eder), 1 başarısız (kayıtlar, bölüm
9), 2 iptal edildi ya da /ACCEPT_EULA eksik.
Sihirbaz kurulum motorunu çalıştırır; yöneticiler motoru doğrudan da
kullanabilir: kernoviq help seçenekleri listeler (portlar, --local,
--allowed-cidrs, --firewall-public, WSL paketinin ve Ubuntu imajının yerel
kopyaları).
3. Kurulumun kurdukları
| Parça | Ne olduğu |
|---|---|
C:\Program Files\KERNOVIQ |
program: kernoviq.ps1 (motor ve komutlar), bin\kernoviq.cmd (sistem PATH'inde), proxy (proxy\caddy.exe), lisans metinleri, uninstall.exe |
C:\ProgramData\KERNOVIQ |
config.json, logs\, backups\, keys\backup.key, kernoviq-ca.crt, proxy'nin ayarları ve sertifikası (proxy\), dağıtımın diski (wsl\) |
| KERNOVIQ WSL dağıtımı | Ubuntu 24.04 (Canonical'ın imajı, sabitlenmiş SHA-256'sıyla denetlenir), systemd, Ubuntu arşivinden Docker Engine ve Compose v2, otomatik güvenlik güncellemeleri. Windows programlarına ve Windows sürücülerine erişimi yoktur. KERNOVIQ /opt/kernoviq altındadır ve Linux'taki gibi kernoviqctl ile işletilir |
| kernoviq-wsl hesabı | dağıtımın sahibi olan yerel hesap. Rastgele parolasını yalnızca Görev Zamanlayıcı bilir ve parolanın süresi dolmaz; yalnızca zamanlanmış görev çalıştırabilir — yerel, Uzak Masaüstü ya da ağ üzerinden oturum açması yasaktır — ve oturum açma ekranında görünmez |
\KERNOVIQ\Distribution görevi |
Windows açılışında, kimse oturum açmadan: dağıtımı çalışır tutar, durursa yeniden başlatır; yeni yedekleri saatte bir dışarı kopyalar |
\KERNOVIQ\Run görevi |
yöneticilerin kernoviq komutlarını dağıtımın içinde yürütür |
| KernoviqProxy hizmeti | NT SERVICE\KernoviqProxy sanal hesabıyla Caddy: 443'te HTTPS (TLS 1.2 ve 1.3), 80'den yönlendirme, yeniden başlatmadan sonra KERNOVIQ açılırken bir "başlıyor" sayfası; sunucu adına ve bu bilgisayarın IP adreslerine hizmet verir, başka host adları sunucu adına yönlendirilir. Yalnızca bu bilgisayarın erişebildiği 127.0.0.1:8280'e iletir |
| güvenlik duvarı kuralları (KERNOVIQ grubu) | yalnızca proxy hizmeti için gelen 443 ve 80; Etki Alanı ve Özel ağlarda (--firewall-public Ortak ağı da ekler) |
| WSL ayarları | hizmet hesabının .wslconfig dosyası: WSL sanal makinesinin belleği (bilgisayarın belleğinin dörtte üçü, 4 ile 16 GB arası, Windows'a en az 2 GB bırakır; kernoviq memory GB ile değişir) |
| Uygulama olay günlüğü | KERNOVIQ kaynağı: kurulum, yükseltmeler ve dağıtım durmaya devam ederse bir uyarı (olay 1001) |
--local ile kurulduysa (yalnızca bu bilgisayar) proxy hizmeti ve güvenlik
duvarı kuralı yoktur: KERNOVIQ bu bilgisayarda http://127.0.0.1:8280
adresinden yanıt verir. Deneme sürümü ağa açılmadan önce yapılmış deneme
kurulumları da böyledir ve yükseltmelerde böyle kalır.
4. Kullanıcılar ve ağ
- Ad ya da adres: kullanıcılar sunucu adını — kullanıcılar için bu
bilgisayarı göstermelidir (DNS'inizde bir A kaydı) — ya da bu bilgisayarın IP
adresini açar. Sertifika bu ad ve bilgisayarın IPv4 adresleri için verilir;
başka adlar sunucu adına yönlendirilir. Adres değişince (DHCP)
kernoviq cert renewyenisini ekler. - İç CA:
C:\ProgramData\KERNOVIQ\kernoviq-ca.crtdosyasını kullanıcıların bilgisayarlarına dağıtın, ör. grup ilkesiyle (Bilgisayar Yapılandırması → İlkeler → Windows Ayarları → Güvenlik Ayarları → Ortak Anahtar İlkeleri → Güvenilen Kök Sertifika Yetkilileri).kernoviq ca --trustbu bilgisayarda da güvenilir yapar. - Kendi sertifikanız sonradan:
kernoviq cert install --cert DOSYA --key DOSYA [--ca DOSYA](PEM, önce sunucu sertifikası). İç CA'nın sunucu sertifikasıkernoviq cert renewile yenilenir;kernoviq doctorsüresi dolmadan 30 gün önce uyarır. - Güvenlik duvarı: kurallar Etki Alanı ve Özel ağlarda geçerlidir.
Windows'un Ortak saydığı bir ağdaki kullanıcılar bağlanamaz: ağı Özel olarak
sınıflandırın ya da
--firewall-publicile kurun. - İç sistemler (dizin, e-posta aktarıcısı, webhook'lar, özel aralıklardaki
tarama hedefleri): kurulumda
--allowed-cidrsya da kapali-ag-kurulumu.md bölüm 8'deki gibikernoviq ctl.
5. Günlük işletim
Yönetici komut isteminde ya da PowerShell penceresinde:
| Komut | |
|---|---|
kernoviq status |
neyin çalıştığı ve KERNOVIQ'in yanıt verip vermediği |
kernoviq doctor |
Windows'u, WSL'yi, dağıtımı, proxy'yi, sertifikayı, DNS'i, güvenlik duvarını ve yedekleri öneriyle denetler |
kernoviq start, stop, restart |
bütün uygulama; restart web (tek servis) |
kernoviq logs [-f] [SERVİS] |
uygulamanın kayıtları |
kernoviq backup |
hemen şifreli yedek |
kernoviq restore DOSYA [--force] |
bütün veriyi bir yedekle değiştirir (önce mevcut durumun yedeği alınır) |
kernoviq cert show, renew, install |
sunucu sertifikası |
kernoviq ca [--trust | --untrust] |
iç CA sertifikası |
kernoviq proxy reload |
proxy ayarlarını yeniden yazar ve proxy'yi yeniden başlatır |
kernoviq memory [GB] |
WSL sanal makinesinin belleği (KERNOVIQ yeniden başlar) |
kernoviq ctl ARGÜMANLAR… |
geri kalan her şey için dağıtımın içinde kernoviqctl (kapali-ag-kurulumu.md) |
kernoviq upgrade, uninstall, version, help |
Windows yeniden başladıktan sonra KERNOVIQ, kimse oturum açmadan birkaç dakikada geri gelir; o zamana kadar kullanıcılar "başlıyor" sayfasını görür.
6. Yedekler
KERNOVIQ her gece ve her yükseltmeden önce dağıtımın içinde şifreli yedek alır.
Yeni yedekler saatte bir C:\ProgramData\KERNOVIQ\backups klasörüne
kopyalanır: bu klasörü Windows yedeğinize ekleyin. En az 7 yeni kopya kaldığı
sürece 45 günden eski kopyalar silinir.
Yedekler yedek anahtarı ile şifrelenir
(C:\ProgramData\KERNOVIQ\keys\backup.key, yalnızca yöneticiler okuyabilir).
Bir kopyasını bu bilgisayarın dışında saklayın. Geri yüklemek için:
kernoviq restore C:\ProgramData\KERNOVIQ\backups\kernoviq-<tarih>-<etiket>.kqbak
Kaldırma, yedekleri ve anahtarı yerinde bırakır. Aynı bilgisayara yapılan yeni
kurulum, kendi yedeğini almadan önce o anahtarı devralır; böylece eski yedekler
yeni kuruluma geri yüklenebilir. Orada farklı bir anahtar bulunursa silinmez,
backup-<tarih>.key adıyla saklanır. Başka bir bilgisayara geri yüklemek için
anahtarı orada KERNOVIQ'i kurmadan önce
C:\ProgramData\KERNOVIQ\keys\backup.key olarak kopyalayın, sonra yedeği yeni
kuruluma geri yükleyin.
7. Yükseltme
Yeni kurulum programını çalıştırın. Önce yedek alır, dağıtımı ve KERNOVIQ'i
yükseltir; yükseltme başarısız olursa önceki sürüme kendiliğinden döner.
Ayarlar, veriler ve sertifikalar korunur. Kurulumun çalıştırdığı yapı korunur:
tam sürüm (deneme sürümünden geçmiş olanlar dahil) etkin lisans anahtarıyla
lisans sunucusundan indirilir; anahtarın yeni sürümü kapsaması gerekir
(güncelleme süresi). Deneme kurulumunu elle tam sürüme geçirmek için:
kernoviq ctl upgrade-edition. Aynı sürümü yeniden çalıştırmak
Windows tarafını onarır (hesap, görevler, proxy, PATH). Gözetimsiz:
KERNOVIQ-Setup-<sürüm>.exe /S /ACCEPT_EULA.
WSL'nin kendisi yeniden başlatma isteyen bir güncelleme gerektirirse kurulum
bunu söyler (çıkış kodu 3010): Windows'u yeniden başlatın ve kurulum
programını bir kez daha çalıştırın.
8. Kaldırma
Ayarlar → Uygulamalar → KERNOVIQ → Kaldır (ya da program klasöründeki
uninstall.exe). Son bir yedek alır; sonra proxy hizmetini, güvenlik duvarı
kurallarını, dağıtımı ve diskini, görevleri, hizmet hesabını ve profilini,
program klasörünü kaldırır. Yedekler ve yedek anahtarı
C:\ProgramData\KERNOVIQ altında kalır; onları da silmek için Tüm verileri,
yedekleri ve yedek anahtarını da sil kutusunu işaretleyin.
Gözetimsiz: "C:\Program Files\KERNOVIQ\uninstall.exe" /S (yedekler kalır) ya
da /S /PURGE (her şey silinir). Çıkış kodları: 0 kaldırıldı, 1
başarısız, 2 iptal edildi. WSL'nin kendisi kurulu kalır: başka yazılımlar
kullanıyor olabilir.
9. Sorun giderme
Kayıtlar: C:\ProgramData\KERNOVIQ\logs — install-*.log, upgrade-*.log,
uninstall-*.log, distribution.log (dağıtımı çalışır tutan görev),
run.log (istek görevi), proxy.log. Olay Görüntüleyicisi → Uygulama
KERNOVIQ kaynağının olaylarını gösterir. Sorunların çoğunu kernoviq doctor
gösterir.
| Belirti | Neden ve çözüm |
|---|---|
hardware virtualization is off |
ürün yazılımında Intel VT-x / AMD-V'yi açın; Hyper-V sanal makinesinde: Set-VMProcessor -VMName AD -ExposeVirtualizationExtensions $true (VMware: "Expose hardware assisted virtualization") |
cannot run WSL 2 as KERNOVIQ needs it |
Windows'u 10 22H2, 11 ya da Server 2022 ve üstüne güncelleyin |
this computer is a domain controller |
üye bir sunucuya kurun |
TCP port 443 is already in use |
portu başka bir web sunucusu (IIS) tutuyor: o siteyi durdurun ya da --https-port ile kurun |
| kullanıcılar sertifika uyarısı alıyor | bilgisayarları iç CA'ya henüz güvenmiyor (bölüm 4) ya da sertifikada olmayan bir adı kullanıyorlar: sunucu adını kullanın |
Windows'taki curl.exe: CERT_TRUST_REVOCATION_STATUS_UNKNOWN |
iç CA iptal listesi yayımlamaz, Windows'un curl'ü ise onu arar; tarayıcılar aramaz: --ssl-no-revoke ekleyin (betikler ve izleme) |
| kullanıcılar hiç bağlanamıyor | DNS bu bilgisayarı göstermiyor ya da ağ Windows için Ortak (bölüm 4); kernoviq doctor ikisini de denetler |
| "başlıyor" sayfası gitmiyor | dağıtım açılmıyor: kernoviq doctor, distribution.log; olay 1001 dağıtımın durmaya devam ettiğini gösterir |
| kurulum başarısız oldu | neden sihirbazın ayrıntılarında ve install-*.log dosyasında; sorunu giderip kurulum programını yeniden çalıştırın: yapılmış olanın üzerinden devam eder |
| PowerShell betikleri reddediyor | grup ilkesi imzalı betik istiyor (AllSigned): KERNOVIQ'in betikleri imzalıdır, yayıncının sertifikasını bilgisayarın Güvenilir Yayımcılar deposuna ekleyin |
10. Güvenlik notları
- Dağıtım Windows programlarını başlatamaz ve Windows sürücülerini görmez; Windows ile arasında dosyalar yalnızca istek görevi üzerinden, hizmet hesabıyla taşınır.
- Ağı yalnızca proxy hizmeti dinler. KERNOVIQ'in kendi 8280 portu
127.0.0.1'e bağlıdır; PostgreSQL, Valkey ve API dağıtımın dışına açılmaz. - Yedek anahtarını, proxy'nin özel anahtarını ve ayarları yalnızca yöneticiler ve SYSTEM okuyabilir; hizmet hesabı yalnızca çalıştığı klasörleri değiştirebilir.
- Kurulum programı, kaldırma programı ve PowerShell betikleri yayıncının kod imzalama sertifikasıyla imzalıdır; kurulumun indirdikleri (WSL, Ubuntu, Caddy, KERNOVIQ) sabitlenmiş sağlama toplamlarıyla ya da sürüm imzasıyla denetlenir.
- KERNOVIQ Windows'tan da telemetri göndermez.