Kendi sunucunuzda kurun. Ekibiniz kendi işleriyle başlasın.
BT ekibiniz yönetim sunucusunu ve işleri çalıştıracak makineleri hazırlar. Ardından ekibiniz bir araştırma, içerik, dosya ya da yazılım akışıyla başlayabilir. Yönetim tarafı (konsol, API, veritabanı, kuyruk ve yedekler) tek bir Linux sunucuda çalışır; ajanlar sunucuya dışa doğru bağlanan kendi makinelerinizde çalışır.
Git bağlantısı yalnız yazılım projeleri için gerekir. Araştırma, rapor, içerik ve dosya işleri kod deposu istemeyen çalışma alanlarında yürür; sihirbazdaki git adımını atlayabilirsiniz.
Sistem gereksinimleri
| En az | Önerilen | |
|---|---|---|
| Sistem | Linux, x86_64 ya da aarch64 (Ubuntu 22.04+, Debian 12+, RHEL / Rocky / Alma 9+) | Ubuntu 24.04 LTS |
| İşlemci / bellek | 2 çekirdek, 4 GB | 4 çekirdek, 8 GB |
| Disk | 10 GB boş | 20 GB ve üzeri (yedekler veritabanıyla büyür) |
| Yazılım | Docker ≥ 24 ve compose eklentisi ≥ 2.24, OpenSSL ≥ 3, curl | — |
| Ağ | Konsol için bir alan adı; 80 ve 443 portları ya da kendi proxy’nizin arkasında bir HTTPS portu | Sürüm adresine ve imaj kaydına giden HTTPS |
Windows ve macOS yönetim sunucusu olarak desteklenmez (Docker Desktop dahil). İkisi de worker makinesi olarak tam desteklenir.
Kurulum
- 01
Alan adını yönlendirin
Konsol için seçtiğiniz alan adını (ör. ops.example.com) sunucuya yönlendirin.
- 02
Betiği indirip kontrol edin
Kurulum betiğini sürüm adresinden indirin; sürüm duyurusundaki anahtar kimliğini betikteki güvenilen anahtarla karşılaştırın.
- 03
Bir TLS biçimi seçip çalıştırın
Betiği root olarak, üç TLS biçiminden biriyle çalıştırın (aşağıda).
- 04
Sahip hesabını oluşturun
Betik sonunda tek kullanımlık bir kurulum anahtarı gösterir. /setup adresinde anahtarı girip sahip hesabını oluşturun; ilk girişte authenticator uygulamanızı bağlar ve 10 kurtarma kodu alırsınız.
- 05
Kurulum sihirbazını tamamlayın
Organizasyon adı, güvenlik ayarı, ilk makine, git bağlantısı (yalnız yazılım projeleri için), isteğe bağlı entegrasyonlar, ilk proje ve örnek bir iş. Her adım atlanabilir, sonra ana sayfadan devam edilir.
# betiği indirin ve güvenilen anahtarı kontrol edin
$ curl -fsSLO https://<release-url>/<version>/install.sh
$ grep -n "TRUSTED_KEYS=" install.sh
# A) Let’s Encrypt
$ sudo bash install.sh --domain ops.example.com \
--tls letsencrypt --email ops@example.com
# B) Cloudflare
$ sudo bash install.sh --domain ops.example.com \
--tls cloudflare [--tls-cert origin.pem --tls-key origin.key]
# C) kendi ters proxy’niz
$ sudo bash install.sh --domain ops.example.com \
--tls proxy --https-port 8443 --http-port 8080 \
--bind 10.0.0.5 --trusted-proxy 10.0.0.2/32Üç TLS biçimi
- Let’s Encrypt
- Sunucu 80/443’te kendisi yanıt verir, sertifikayı Let’s Encrypt verir.
- Cloudflare
- Alan adı Cloudflare üzerinden; SSL “Full”, origin sertifikasıyla “Full (strict)”.
- Kendi proxy’niz
- TLS’i kendi ters proxy’niz bitirir; port, bağlanılacak adres ve güvenilen proxy belirtilir.
Betik ne yapar?
- Gereksinimleri kontrol eder.
- Sürümü indirir; imzasını ve her dosyasını doğrular. Doğrulama tutmazsa hiçbir şeye dokunmadan durur.
- Veri klasörünü kurar; parolaları ve anahtar dosyalarını bir kez üretir, ekrana asla yazmaz.
- Proxy ayarını yazar, imajları özetleriyle (digest) çeker, veritabanını taşır ve sistemi başlatır.
- Sağlık kontrolünü bekler ve tek kullanımlık kurulum anahtarını bir kez gösterir.
Sık kullanılan seçenekler
--dry-run- Her adımı kontrol eder ve gösterir, hiçbir şeyi değiştirmez.
--version- Belirli bir sürümü kurar (varsayılan: en yenisi).
--registry- Kendi imaj aynanızı kullanır; özetler korunur.
--bundle- Bir sürüm klasörünün çevrimdışı kopyasından kurar.
--backup-recipient- age açık anahtarınız: yedekler anahtar dosyalarını da şifreli taşır.
--data-dir- Veri klasörünün yeri.
Betiği yeniden çalıştırmak güvenlidir: ilk çalıştırmanın parolalarını ve seçimlerini korur. TLS biçimini ya da portları değiştirmek için yeni seçeneklerle yeniden çalıştırmanız yeterlidir.
Makineleri bağlama
Worker’lar Linux (x64, arm64 / Raspberry Pi 64-bit), macOS (Apple silicon ve Intel) ve Windows x64 üzerinde çalışır; Docker worker da desteklenir.
Panelde “Makine ekle”
Makineler → Makine ekle → işletim sistemini seçin.
İki satırı çalıştırın
İlk satır kurulum betiğini indirir; SHA-256 özeti paneldekiyle aynı değilse durur. İkinci satır kiti indirir, imzalı indeksle karşılaştırır ve servisi kurar.
Eşleştirin
Makinede görünen eşleştirme kodunu ve parmak izini panelde karşılaştırın, kodu girip doğrulama koduyla onaylayın.
Panelden yapılandırın
Projeler, runtime’lar, paralel iş sayısı ve sandbox profilleri panelden ayarlanır; makineye tekrar gitmeniz gerekmez.
- Makinede uygun Node.js sürümü yoksa, sabitlenmiş sürüm özet ve imza kontrolüyle yalnızca worker için ayrı bir klasöre kurulur; sistemdeki Node ve PATH’e dokunulmaz.
- İnternetten indirme istemiyorsanız kurulum paketini panelden indirip makineye kopyalayabilirsiniz.
- Paneldeki komutlarda gizli bilgi ya da token bulunmaz; onay verilmeden hiçbir makineye güvenilmez.
Worker gereksinimleri
Worker, işleri çalıştıran makinedir. Kendi düşük yetkili hesabıyla, işletim sisteminin servisi olarak çalışır; açılışta başlar, çökerse yeniden başlar.
| Sistem | Servis | Notlar |
|---|---|---|
| Linux · x64, arm64 | systemd servisi, kendi sistem hesabıyla | Raspberry Pi için 64-bit Raspberry Pi OS. Container profili için isteğe bağlı rootless Docker ya da Podman. |
| macOS · Apple silicon, Intel | LaunchDaemon; oturum açmadan başlar | Worker hesabı ev klasörünüzü ve anahtar zincirinizi okuyamaz. |
| Windows 10 / 11 · x64 | Windows servisi, sanal servis hesabıyla | Kurulum yönetici olarak açılmış PowerShell’de yapılır. Paralel işler için iş başına hesaplar Sandbox kartından hazırlanır. |
| Docker worker | Docker çalıştıran bir Linux makinede konteyner olarak | Diğer worker’larla aynı eşleştirme akışıyla bağlanır. |
Node.js 24: makinede sistem genelinde kuruluysa o kullanılır. Normal bir kullanıcının değiştirebileceği kurulumlar (nvm, kullanıcıya ait Homebrew, Windows’ta kullanıcı klasörü) kabul edilmez. Uygun Node yoksa panel kurulumu sabitlenmiş sürümü özet ve imza kontrolüyle yalnızca worker için ayrı bir klasöre kurar.
Ağ: worker’ın kontrol düzleminin adresine dışa doğru HTTPS/WSS ile ulaşabilmesi yeterlidir; içeriye port açılmaz.
Ajan CLI’ları
Worker kurar ve yönetir. Claude Code, Codex, opencode ve pi’nin sabitlenmiş sürümleri Makineler → makine → Runtime’lar ekranından kurulur, güncellenir, geri alınır ya da kaldırılır; her sürüm sağlama toplamıyla doğrulanır. Makineye girip elle kurmanız gerekmez.
Abonelikle kullanım. Runtime’ın kendi girişi panelden başlatılır ve o makinede, worker hesabıyla yapılır. Aynı abonelik girişini kullanan işler sırayla çalışır.
API anahtarıyla kullanım. Anahtarı Ayarlar → Kimlik bilgileri’nden kasaya ekler, hangi makinelere gideceğini seçersiniz; değer her makine için ayrı mühürlenir.
Hesaplar sizin. Remyral sistemi sağlar; modelleri siz kendi hesaplarınızla kullanırsınız — abonelikle (ör. Claude, ChatGPT) ya da API anahtarıyla. Abonelik ve API kullanımı sağlayıcının koşullarına tabidir.
Örnek topoloji
Küçük bir ekip için tipik bir başlangıç. Adlar örnektir.
Kontrol düzlemi · Ubuntu 24.04 LTS, 4 çekirdek, 8 GB · yalnızca 80/443 açık
- build-01Linux x64 · container profili · Claude Code, Codex
- mac-studiomacOS arm64 · runtime-sandbox · Claude Code, opencode
- win-ops-02Windows 11 x64 · iş başına hesap · Codex, pi
Üç makine de kontrol düzlemine dışa doğru bağlanır; hiçbirinde içeriye port açılmaz. Pilot kapsamı en fazla 3 makinedir.
Güncelleme
Yeni imzalı bir sürüm çıktığında sahipler konsolda “Güncelleme mevcut” bandını görür: sürüm notları, uyumsuz değişiklikler ve komut. Güncelleme her zaman sunucuda, sizin başlattığınız bir komutla yapılır.
doğrula
çek
master’ı durdur
yedek al
taşı
başlat
sağlık kontrolü
Önce kontrol. Yeni sürüm olup olmadığını sorgulayabilir, adımları kuru çalıştırmayla (dry-run) önceden görebilirsiniz.
Zorunlu yedek. Güncelleme öncesi yedek alınamazsa hiçbir şey değişmez ve sistem eski haliyle yeniden başlar.
Uyumsuz değişikliklerde onay. Uyumsuz değişiklik içeren bir sürüm açıkça onay ister.
Geri dönüş. Sağlık kontrolü geçmezse ve veritabanı şeması değişmediyse eski sürüm kendiliğinden geri gelir. Şema ilerlediyse komut, güncelleme öncesi yedeği geri yükleyen geri dönüş komutunu yazar.
Makineler kendini günceller. Sürüm notları gereken en düşük worker sürümünü belirtir; worker sürümleri imzalıdır ve kademeli yayılır.
Yedek, tanılama ve kaldırma
Gece yedeği
Yedek servisi her gece veritabanını yedekler ve geri yükleme provası yapar; durum Ayarlar → Yedekler’de. İsterseniz elle de yedek alınır.
Anahtarları sunucu dışında saklayın
Ayar dosyasını ve anahtar klasörünü bir parola yöneticisinde tutun; authenticator anahtarı olmadan herkes uygulamasını yeniden bağlamak zorunda kalır.
Tanılama
Ayarlar → Tanılama, kontrol düzlemini ve bağlı makineleri tek tıkla denetler; bulgular öneri ve ilgili sayfanın bağlantısıyla gelir. Aynı kontroller sunucudan da çalıştırılabilir.
Destek raporu
Sorunu anlatın, bölümleri seçin, zip’in içindeki her dosyayı önizleyin; indirin ya da e-postayla gönderin. Parolalar, token’lar ve anahtarlar rapora girmez.
Portlar
Sunucuda dışarıya yalnızca ters proxy’nin portları (80/443 ya da sizin seçtikleriniz) açılır.
Kaldırma
Kaldırma kapsayıcıları siler, veri klasörünü bırakır. Veritabanını, yedekleri ve anahtarları da silmek ayrı ve geri alınamaz bir seçenektir.
Sorun giderme
En sık karşılaşılan durumlar ve ilk yapılacaklar. Çözülmezse Ayarlar → Tanılama’dan maskeli bir destek raporu hazırlayıp bize gönderin.
Kurulum betiği “özet uyuşmuyor” diyerek duruyor
İndirilen betik, paneldeki SHA-256 özetiyle aynı değil. Komutları panelden yeniden kopyalayın; sorun sürerse betiği çalıştırmayın ve bize yazın.
Makine eşleşme bekleyenler listesinde görünmüyor
Makinenin kontrol düzleminin adresine dışa doğru HTTPS/WSS ile ulaşabildiğini kontrol edin. Eşleştirme kodu ve parmak izi kurulumun sonunda ve servis kaydında yazar. Kurulumu yeniden çalıştırmak güvenlidir.
Servis başlıyor, sonra duruyor ve yeniden başlamıyor
Bu bir yapılandırma, dosya izni ya da anahtar deposu sorunudur (çıkış kodu 78); servis bu durumda bilerek yeniden başlamaz. Servis kaydı neyin düzeltilmesi gerektiğini yazar; düzeltip servisi başlatın. macOS bu durumu çökmeden ayıramaz ve 10 saniyede bir yeniden dener.
Kurulum Node.js’i kabul etmiyor
Worker, normal bir kullanıcının değiştirebileceği bir Node kurulumunu reddeder (nvm, kullanıcıya ait Homebrew, Windows’ta kullanıcı klasörü). Sistem geneli Node 24 kurun ya da panel kurulumunun worker’a özel Node kurmasına izin verin.
Raspberry Pi bağlanmıyor
64-bit Raspberry Pi OS gerekir; 32-bit sistemler desteklenmez.
Bir sandbox profili “hazır değil” görünüyor
Sandbox kartı nedeni ve kimin düzeltebileceğini yazar. Linux’ta container profili rootless Docker ya da Podman ister; kartın “Prepare” düğmesi ayrıcalıklı yardımcıyla Podman’ı kurabilir. “Makine sahibi gerekli” yazan adımları yalnızca makinenin yöneticisi yapabilir.
Windows’ta işler paralel çalışmıyor
İş başına hesaplar, makinede bir çapraz erişim testi geçtikten sonra açılır: Sandbox kartında “Prepare”i ayrıcalıklı yardımcıyla çalıştırın. Test geçmezse işler sırayla çalışır ve kart nedenini yazar. Aynı abonelik girişini kullanan işler her zaman sırayla çalışır.
İş kuyrukta bekliyor
İşin sayfası nedenini gösterir: anahtar o makineye henüz ulaşmamış, seçilen model o runtime için tanımlı değil ya da uygun sandbox profili hazır olmayabilir. İş sayfasındaki bağlantı ilgili makinenin Sandbox kartını açar.
Kurulumu pilotla birlikte yapalım.
Dört haftalık pilotun ilk haftası keşif ve kurulumdur: kontrol düzlemi sizin sunucunuza, 1–3 worker sizin makinelerinize.