CMai OS Belgeleri

Server Edition için kurulumdan güncellemeye kadar ihtiyacınız olan her şey. Tek sayfa; soldaki başlıklardan atlayın.

Başlarken

CMai OS, AI geliştirme sunucuları için geliştirilen kendi Linux dağıtımımızdır: kendi çekirdek yapılandırması, Ed25519 ile imzalı güncelleme kanalı ve kendi ISO'suyla dağıtılır. Dört AI kurulu gelir: CMai (CMai API — tek anahtar, tüm modeller) ile Claude Code, Gemini CLI ve Kimi CLI; her kullanıcı rootless-podman ile izole edilmiş kendi çalışma alanında çalışır. Kurulumdan ilk cmai komutuna giden yol dört adımdır:

Gereksinimler

Tek kullanıcılı bir deneme çok daha küçük bir makinede (ör. 2 vCPU / 4 GB sanal makine) çalışır; yukarıdaki değerler ekip kullanımı için başlangıç noktasıdır.

ISO indirme

Güncel ISO releases.cmaios.net adresinde. Her sürümün yanında bir .sha256 dosyası bulunur; indirdikten sonra doğrulayın:

$ curl -LO https://releases.cmaios.net/cmaios-latest-amd64.iso
$ sha256sum -c cmaios-<sürüm>-amd64.iso.sha256
# cmaios-<sürüm>-amd64.iso: OK

Windows'ta certutil -hashfile cmaios-<sürüm>-amd64.iso SHA256 çıktısını .sha256 dosyasındaki değerle karşılaştırabilirsiniz.

VirtualBox / bare-metal kurulum

VirtualBox: "Linux / Other Linux (64-bit)" tipinde bir makine oluşturun; en az 2 vCPU, 4 GB RAM, 40 GB disk verin. ISO'yu optik sürücüye takın. Ağ modunu Köprü (Bridged) yapın ki sunucu yerel ağınızdan bir IP alsın ve tarayıcıdan ulaşabilin. EFI'yi açık ya da kapalı bırakabilirsiniz.

Bare-metal: ISO'yu USB'ye yazın (dd, Rufus, balenaEtcher), makineyi USB'den başlatın. BIOS ve UEFI ikisi de desteklenir; Secure Boot açıksa firmware ayarlarından kapatın.

Açılış menüsünde kurulum otomatik başlar, disk bölümlenir, paketler kopyalanır ve makine yeniden başlar. Bu sırada müdahale gerekmez.

İlk açılış ve sihirbaz

Kurulumdan sonraki ilk açılışta konsolda (fiziksel ekran ya da sanal makine penceresi) bir kart görürsünüz:

Kurulumu tamamlamak için tarayıcıdan açın

  Adres          https://192.168.1.40:8443
  Kurulum kodu   Q63X-FE73

  Sertifika uyarısında "Gelişmiş → Devam et" seçin.
  Kurulum bitene kadar SSH ve diğer servisler kapalıdır.

1. Adresi açın. Panel kendi imzaladığı bir sertifika kullanır; tarayıcının uyarısında Gelişmiş → Devam et deyin.
2. Kurulum kodunu girin. Karttaki 8 haneli, tek kullanımlık kod (XXXX-XXXX). Konsola erişimi olmayan kimse sihirbazı açamaz.
3. Lisans anahtarı. CMAI-XXXX-XXXX-XXXX-XXXX biçimindeki anahtarınız. Sunucu lisans servisine bağlanır, anahtar bu cihaza bağlanır.
4. CMai API anahtarı. app.cmai.tr/customer/keys adresinden oluşturduğunuz cm-… anahtarı. Tek anahtar, her kullanıcının çalışma alanına işlenir ve CMai CLI (cmai) bununla çalışır; ayrıntı CMai API ve AI araçları bölümünde.
5. Yönetici hesabı. Kullanıcı adı ile SSH açık anahtarı ya da parola. Anahtar önerilir: anahtar verirseniz o kullanıcı için parola girişi açılmaz.

Sihirbaz bittiğinde konsol kartı CMai OS hazır durumuna geçer ve SSH satırını, panel adresini ve lisans özetini gösterir. SSH artık açıktır.

Bağlanma

$ ssh admin@192.168.1.40
CMai OS hazır  ·  çalışma alanı: admin  ·  /workspace
admin@cmai:/workspace $ cmai

Çalışma alanı kavramı

SSH ile giren her kullanıcı ana sisteme değil, kendi çalışma alanına iner: rootless podman ile çalışan, o kullanıcıya özel bir konteyner. İçinde CMai CLI (cmai), claude, gemini, kimi, derleyiciler ve git hazırdır. Ev dizini HOME=/workspace'tir ve kalıcıdır; konteyner yeniden başlasa da dosyalarınız durur. CPU, RAM ve süreç sayısı kullanıcı başına kotalıdır (cmai user add ile belirlenir).

CMai API ve AI araçları

CMai API — tek anahtar, tüm modeller. CMai, CMApps tarafından geliştirilen kurumsal yapay zeka platformudur (cmai.tr): sohbet, görsel, ses-video ve embedding tek standart API'de (OpenAI uyumlu Chat Completions); kredi yönetimi ve canlı izleme dahil. CMai OS'ta sihirbazın AI adımında girdiğiniz tek CMai API anahtarı her kullanıcının çalışma alanına işlenir; çalışma alanında cmai (ya da cmai code) komutu bu API üzerinde çalışan, terminalde yaşayan CMai yapay zeka kodlama ajanı CMai CLI'ı başlatır (varsayılan model cmai-pro).

CMai CLI (@cmapps/cmai-cli) her çalışma alanında önceden kuruludur ve sunucunun anahtarıyla CMai API'ye otomatik bağlanır (CMAI_API_KEY / CMAI_MODEL / CMAI_BASE_URL). Otomatik hafıza, beceriler (skills), alt-ajanlar ve MCP desteği vardır: cmai -p "…" tek seferlik komut çalıştırır, cmai mcp add … MCP sunucusu ekler, proje köküne konan CMAI.md kalıcı talimat verir. Ayarlar /workspace/.cmai altında kalıcıdır. Modeller: cmai-pro, cmai-balanced, cmai-fast, cmai-vision. Kendi makinenize kurmak için: npm install -g https://cmai.tr/downloads/cmai-cli-latest.tgz.

1. Anahtar alın: app.cmai.tr/customer/keys adresinde bir anahtar oluşturun (cm-… ile başlar).
2. Girin: sihirbazın AI adımında; sonradan değiştirmek için yerel yönetici paneli https://<ip>:8443.
3. Kullanın: SSH ile girin, cmai yazın (cmai code da aynı şeyi yapar).

admin@cmai:/workspace $ cmai
╭─ CMai CLI · cmai-pro ─────────────────╮
│  > Testleri çalıştır ve failing olanları düzelt  │
╰───────────────────────────────────────╯

Çalışma alanında hazır ortam değişkenleri — OpenAI uyumlu her araç (SDK'lar, editör eklentileri, kendi betikleriniz) ek ayar olmadan CMai API'ye bağlanır:

API uç noktaları: POST /v1/chat/completions (SSE ile akış, tool/function calling, metin · görsel · PDF · ses · video girdisi), /v1/embeddings, /v1/files, /v1/models. Kimlik doğrulama Authorization: Bearer cm-…. Modeller (7): cmai-pro (varsayılan, 200K bağlam), cmai-balanced (200K), cmai-fast (128K), cmai-vision (1M), cmai-av (ses-video, 1M); embedding için cmai-embed-small ve cmai-embed-large (yüksek kaliteli, 8K). Tam referans: docs.cmai.tr/docs.

$ curl "$CMAI_BASE_URL/chat/completions" -H "Authorization: Bearer $CMAI_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"model":"cmai-fast","messages":[{"role":"user","content":"Merhaba"}]}'

Host komutları

Ana sistemdeki komutlar (cmai …, systemctl, journalctl) çalışma alanının içinden görünmez. Yönetici bunları SSH'ın komut argümanıyla, sudo üzerinden çalıştırır:

$ ssh admin@192.168.1.40 "sudo cmai license status"
$ ssh admin@192.168.1.40 "sudo cmai user add ayse --cpus 2 --mem 4096 --ssh-key 'ssh-ed25519 AAAA…'"
$ ssh admin@192.168.1.40 "sudo journalctl -u cmai-workspace-ayse -f"

Aynı komutları sunucunun konsolundan doğrudan da verebilirsiniz.

CLI referansı

Yönetim CLI'ı cmai ana sistemde çalışır ve root gerektirir (sudo); çalışma alanındaki CMai CLI (cmai) ile karıştırmayın. Alt komutlar:

Lisanslama

CMai OS çevrimiçi etkinleştirme kullanır (Windows'taki gibi): anahtar bir kez cihaza bağlanır, sunucu lisansını çevrimiçi doğrular.

Planlar: Trial (14 gün, 1 kullanıcı, ücretsiz), Solo (1 kullanıcı, $29/ay), Team (5 kullanıcı dahil, en fazla 20; $99/ay, ek kullanıcı $19/ay), Enterprise (20+ kullanıcı, çoklu sunucu; sunucu başına $499/ay'dan başlayan, teklifle). Fiyatlar USD ve KDV hariçtir, AI kullanım ücretleri dahil değildir; güncel liste cmaios.com/#planlar. Anahtar için isgelistirme.ortaklik@cmapps.com.tr.

Yönetim paneli

Sihirbazın çalıştığı adres kurulumdan sonra yönetici paneline dönüşür: https://<ip>:8443. Sihirbazda oluşturduğunuz yönetici hesabıyla girilir. Lisans sayfasında:

• Lisans durumu (etkin / kilitli / lisans yok), plan, kullanıcı sayısı ve geçerlilik
• Cihaz kimliği, bağlantı durumu ve lisans sunucusu adresi
• Yenile: sunucuyla hemen eşitle
• Yeni lisans anahtarı / anahtarı değiştir: kilitli sunucuyu açmanın tarayıcı yolu
• CMai API anahtarı: sihirbazda girilen anahtarı değiştirme (tüm çalışma alanlarına işlenir; CMai CLI bununla çalışır)
• Bağlantı özeti: SSH satırı, yönetici adı, sürüm

Panel yalnızca yerel ağdan ya da sunucunun IP'sinden erişilecek şekilde tasarlanmıştır; sertifikası kendi imzalıdır.

Güvenlik

CMai OS askeri düzey şifreleme standartlarıyla (AES-256 / Ed25519 / TLS 1.3) gelir ve varsayılanları sıkıdır. Aşağıdaki önlemlerin tümü kutudan çıktığı gibi etkindir; hiçbiri için ek ayar gerekmez.

Tam disk şifreleme, FIPS sertifikasyonu ve donanım tabanlı anahtar saklama (TPM zorunluluğu) bu sürümde yoktur; yol haritasında değerlendirilmektedir. Güvenlik bildirimleri için security.txt.

Sorun giderme

SSH: Permission denied (publickey)

Sunucu yalnızca anahtarla girişi kabul ediyor ve gönderdiğiniz anahtarı tanımıyor. Kontrol listesi:

• Doğru anahtarı kullandığınızdan emin olun: ssh -i ~/.ssh/id_ed25519 admin@<ip>
• Sihirbazda parola seçtiyseniz parola girişi açıktır; istemciniz anahtar denemesinde takılıyorsa ssh -o PubkeyAuthentication=no admin@<ip>
• Başka bir kullanıcının anahtarını eklemek için yönetici: sudo cmai user add <ad> --ssh-key "…"

"Çalışma alanınız hazırlanıyor"

İlk girişte kullanıcının konteyneri oluşturulur; workspace imajı hazırlanıyorsa bu birkaç dakika sürebilir. İlerlemeyi ana sistemden izleyin:

$ ssh admin@<ip> "sudo journalctl -u cmai-workspace-<ad> -f"

Takılı kalırsa sudo cmai user stop <ad> ardından sudo cmai user start <ad>; genel sağlık için sudo cmai doctor.

Konsol kartı IP göstermiyor

Kart, ağ arayüzü adres almadan önce çizilmiş olabilir. Konsolda Enter'a basın; kart güncel bilgiyle yeniden çizilir. Hâlâ IP yoksa DHCP'yi ve (sanal makinede) ağ modunun Köprü olduğunu kontrol edin.

Sistem kilitli

Kart Sistem kilitli — lisans geçerli değil diyorsa nedeni de yazar (süre doldu, askıya alındı, lisans servisine ulaşılamıyor). Lisanslama bölümündeki gibi panelden ya da cmai license activate ile yeni anahtar girin; bağlantı sorunuysa cmai license renew.

Sürümler ve güncelleme

Sürüm numarası biçimi: 0.1.0-dev.<n>+<sha> — n derleme sayacı, sha kaynak kodun kısa git özeti. Kurulu sürümü cmai license status çıktısında ve panelde görürsünüz; ISO'ların yanındaki -BUILD.txt dosyası derleme ayrıntılarını içerir.

Güncellemeler cmai update check / cmai update apply ile yönetilir; kanal stable, beta ya da nightly olabilir. Paket tabanlı apt kanalı (apt.cmaios.net) yakında; o zamana kadar yeni sürümler releases.cmaios.net üzerinden ISO olarak yayınlanır.

Sık sorulanlar

Ürünle ilgili genel sorular (fiyat, planlar, donanım) için cmaios.com/#sss.

Sözlük

Çalışma alanı (workspace)

Bir kullanıcıya ait, rootless podman ile çalışan izole konteyner. SSH girişi doğrudan buraya düşer; HOME=/workspace kalıcıdır.

Kullanıcı sayısı

Lisansın izin verdiği kullanıcı sayısı. Her "cmai user add" bir kullanıcı hakkı kullanır.

Sunucu sınırı (max devices)

Aynı anahtarın aynı anda etkin olabileceği sunucu sayısı.

Cihaz kimliği (device id)

Etkinleştirme sırasında sunucudan türetilen ve anahtara bağlanan benzersiz kimlik; varsa TPM ile güçlendirilir.

Doğrulama

Sunucunun lisansını license.cmaios.net üzerinden çevrimiçi doğrulaması; kullanıcı müdahalesi gerekmez.

Kilit modu

Lisans geçersizken girilen durum: SSH, çalışma alanları ve yayınlar durur, veri korunur.

Kanal (channel)

Güncelleme akışı: stable (kararlı), beta, nightly (gece). "cmai update channel" ile seçilir.

Konsol kartı

İlk açılışta ve sonrasında fiziksel konsolda gösterilen durum kartı: panel adresi, kurulum kodu, SSH satırı, lisans özeti.

Kurulum kodu

Sihirbazı açmak için gereken tek kullanımlık 8 haneli kod (XXXX-XXXX); yalnızca konsolda görünür.

CMai API anahtarı

app.cmai.tr/customer/keys adresinden alınan cm-… anahtarı. Sihirbazda bir kez girilir, her çalışma alanına CMAI_API_KEY olarak işlenir; CMai CLI ("cmai") bununla çalışır.

Anahtar ipucu (key hint)

Anahtarın son dört karakteri (CMAI-…-XXXX). Portal ve e-postalarda anahtarın tamamı yerine bu gösterilir.