OpenBot AI iş arkadaşlarını VPS üzerinde barındırma
OpenBot AI iş arkadaşlarını kendi sunucunuzda çalıştırmak için gerekli yapılandırmayı öğrenin. Her botun kendi konteyner ve tarayıcısını kullanması için gereken RAM maliyetleri.
Self-host OpenBot AI coworker kullanıldığında elde edilenler
OpenBot AI coworker’larını self-host etmek için, kontrolünüzdeki donanım üzerinde bir gateway server çalıştırılır ve her bota ayrı bir container sağlayan bir supervisor kullanılır. Her bota özel bu container yalnızca COMPUTER_SUPERVISOR_URL ayarlandığında oluşturulur. Bu ayar olmadan tüm botlar AGENT_COMPUTER_URL üzerindeki tek bilgisayarı paylaşır. Supervisor kullanıldığında her bot container’ı kendi Chromium tarayıcısını ve kendi workspace volume’unu barındırır; tarayıcı profili oturumlar arasında korunur. Bir botun bilgisayar, dosya, MCP (model context protocol) server veya UI bileşeni üzerinde gerçekleştirdiği her işlem önce bu gateway üzerinden geçer. Gateway, işlem gerçekleşmeden önce işlemi bir policy ile karşılaştırır ve işlem sonrasında kaydeder. Gateway’in sarmaladığı agent loop kavramı hâlâ yeni ise AI agent’larını sıfırdan öğrenme başlığındaki aşamalı yol, bir bota tarayıcı ve giriş bilgilerinizi vermeden önce küçük bir agent loop’u kendiniz yazmanızı sağlar.
OpenBot, CopilotKit tarafından MIT lisansı ile github.com/CopilotKit/openbot adresinde yayımlanır. İlk etiketli sürüm v0.0.1, 17 August 2026 tarihinde yayımlandı; v0.2.0 ise 12 October 2026 tarihinde yayımlandı. 10 November 2026 itibarıyla en güncel sürüm v1.0.0’dur. Bu sürüm 9 November 2026 tarihinde, v0.3.0 sürümünden üç gün sonra yayımlandı. main üzerindeki README dosyasında artık beta bildirimi bulunmuyor. Bu sürüm, erken aşamaya özgü eksikleri bulunan ciddi bir tasarım olarak değerlendirilmelidir. Aşağıdaki deployment v0.2.0 sürümüne sabitlenmiştir ve buradaki her adım bu sürümü açıklar. v0.3.0 approval, browser sharing ve Helm chart varsayılanlarını değiştirmiştir. Bu nedenle daha yeni bir tag ile başlamadan önce v0.3.0 ve v1.0.0 release notes belgeleri okunmalıdır. Güncel main, her kişiye bir container sağlar ve Isolated olarak işaretlenen her bota kendi container’ını verir.
Bu mimarinin ilgi çekici yanı aynı zamanda en maliyetli kısmıdır. Her agent için bir browser çalıştırılması, çoğu kişinin planlamayı unuttuğu bellek maliyetidir. Bu nedenle burada kurulumdan önce boyutlandırma yapılır.
Ağ geçidinin her eyleme nasıl karar verdiği
3001 numaralı port üzerindeki API sunucusu, bir botun bilgisayarına giden denetimli yoldur. Bilgisayar ayrıca token ile korunan daha düşük seviyeli servis uç noktalarını dışa açar. Proje, bunların gizli tutulmasını ve ağ geçidini atlatmak için asla kullanılmamasını belirtir; bu nedenle ağ geçidi, yalnızca bu uç noktalara ulaşılamadığı durumlarda tek yol olarak kalır. Bir tarayıcı eylemi çalışmadan önce ağ geçidi, hedefi bir sayfa anlık görüntüsünden çözer, bağlama karşı CEL (common expression language) ilke kurallarını değerlendirir, kararı içeren bir denetim satırı yazar ve ancak o zaman container'ı çağırır. Eğer yürütme bundan sonra başarısız olursa, ikinci bir satır yazar. Belgeler sınırı açıkça belirtir: bilgisayar ilkeye karar vermez, eylem sınırı sunucu ağ geçididir. Bu ayrımın OpenBot dışında bir adı vardır; çünkü döngü, araç tanımları, izin kontrolleri ve oturum durumu bir araya gelerek bir modelin etrafına sarılmış donanımı oluşturur ve bu ağ geçidi, bu yapının izin tarafıdır.
İlke değerlendirmesi varsayılan olarak reddetme ile sonuçlanır ve reddetme kuralları, izin verme kurallarından önce değerlendirilir. Başarısızlık yönü, kural sözdiziminden daha önemlidir. Eksik veya boş bir ilke hiçbir şeye izin vermez ve hatalı bir kural, reddetme veya izin verme kuralı olmasına bakılmaksızın engelleme yönünde başarısız olur; bu nedenle ilkenizdeki bir hata, hesaplarınızda serbestçe dolaşan bir bot yerine takılıp kalmış bir bota neden olur. OpenBot ile birlikte gelen ilke farklı bir konudur. Başlangıç varsayılanı deny: [] ve allow: ["true"] şeklindedir; bu, AGENT_COMPUTER_POLICY veya kaydedilmiş bir yönetici ilkesi ile değiştirilene kadar her eyleme izin verir. Bu yüzden bot gerçek bir şeye dokunmadan önce kendi ilkenizi yazın. Bu katman, botun ne okuduğunu değil, ne yaptığını yönetir; bu nedenle aracıya yönelik talimatlar içeren bir sayfa ayrı bir sorun olarak kalır. Bu, kendi SearXNG örneğinizden gelen sonuçları bir aracıya verdiğinizde karşılaştığınız istem enjeksiyonu yüzeyi ile aynıdır.
Denetim izi PostgreSQL içinde tutulur, bu nedenle yeniden başlatma sonrasında varlığını korur. Kontrol devirleri computer.help_requested, computer.control_taken ve computer.control_released olarak kaydedilir; botun insandan yardım istediğini ve insanın kontrolü nasıl geri verdiğini bu şekilde görürsünüz. Sırlar, değer olarak değil, karakter sayısı olarak kaydedilir. Dosya okuma, yazma ve listeleme işlemleri Activity sekmesinde görünür; burada kaydedilen bir dosya, içeriğiyle değil, yolu ve boyutuyla görüntülenir. Bu görünüm tarayıcıda tutulur ve denetim kaydı değildir. Arkasında bir tarayıcı olmadan aynı kontrol sınırını istiyorsanız, yapay zeka aracı eylemlerini onay mekanizmalarıyla sınırlandırmak bu daha dar kapsamlı durumu ele alır.
Bir botun RAM ve disk maliyeti
Proje, arm64 mimarisinde tek bir Bot için ölçülen değerleri yayınlamaktadır. Bunlar, dağıtım belgelerinde yer alan boyutlandırma rakamlarıdır ve tek bir mimarideki tek bir botu tanımlarlar; bu nedenle bunları bir kapasite planından ziyade başlangıç noktası olarak değerlendirin.
Bu grafiğin arkasındaki veriler
[
{
"label": "Measured, one Bot",
"memory_gb": 0.55,
"disk_gb": 1.4,
"vcpu": 0.06
},
{
"label": "Documented minimum",
"memory_gb": 2,
"disk_gb": 4,
"vcpu": 1
},
{
"label": "Documented recommended",
"memory_gb": 4,
"disk_gb": 8,
"vcpu": 2
}
]Tek bir Bot için tepe bellek kullanımı 0.55 GB olarak ölçülmüştür; belgelenen minimum değer 2 GB, önerilen değer ise 4 GB'dir. Ölçülen değer ile minimum değer arasındaki fark, Chromium'un yük altında büyümesi için ayrılan alandır; çünkü bir tarayıcının bellek kullanımı boşta duran sürece göre değil, açık olan sayfalara göre değişir. Belgeler, aynı anda açılan her ek sayfa için yaklaşık 100 ila 200 MB ek yük öngörmektedir. Boştaki CPU kullanımı, ölçülen aralığın en üstünde bile bir çekirdeğin 0.06 kadarıdır, yani satın almanız gereken kaynak CPU değildir. İmaj boyutu 1.4 GB'dir ve önerilen disk alanı 8 GB'dir; aradaki fark, botun dosyalarını tuttuğu /workspace için ayrılan alandır. İmaj yalnızca Chromium tarayıcı ailesini içerir. Playwright'ın Firefox ve WebKit sürümleri dahil edilmemiştir.
Bunların hiçbiri, birden fazla botun toplam maliyetini göstermez ve proje bunun için bir rakam yayınlamamaktadır. Belgelenen minimum değer, projenin yayınlamaktan çekinmediği bir sayıdır, yük altında gözlemlenmiş bir değer değildir; PhotoPrism ve Immich arasında seçim yapma konusunun yayınlanan değerler yerine ölçülen RAM taban değerlerine dayanmasının nedeni de budur. Kendi ölçümünüzü yapın. Bir bot başlatın, ona açık bir sayfa ile gerçek bir görev verin ve çalışırken container'ı izleyin.
docker stats --no-stream
free -mBotun container'ı için MEM USAGE sütunundaki değeri bot başına düşen rakam olarak alın, üzerine gateway ve PostgreSQL yükünü ekleyin, ardından bu bot başına düşen rakamı aynı anda çalışmasını beklediğiniz bot sayısıyla çarpın. Boştaki bir bot, tarayıcısını boşta kalma zaman aşımı (varsayılan olarak 30 dakika) süresince tutar; bu nedenle çarpan hesabına boşta duran tarayıcıları da dahil edin. Bu aritmetik, bir kodlama ajanı VPS'i için RAM ve CPU boyutlandırma ile aynıdır ve bunun tarayıcı tarafı ajanlar için VPS üzerinde headless tarayıcı çalıştırma bölümünde ele alınmıştır.
Bir Chromium detayı küçük planları etkiler. OpenBot, Chromium'u --disable-dev-shm-usage ile başlatır, böylece tarayıcı /dev/shm yerine /tmp dizinine yazar. Bu, küçük bir /dev/shm alanına sahip sunucularda karşılaşacağınız çökmeleri önler ve yükü kök dosya sisteminize taşır; önerilen disk alanının imaj boyutundan daha büyük olmasının bir nedeni de budur.
VPS üzerinde OpenBot nasıl self-host edilir?
Docker, Bun 1.3 veya daha yeni bir sürüm, bir CopilotKit Intelligence projesi ve lisansı gerekir. Ayrıca bir modele erişim gerekir. Bunun için API anahtarı veya desteklenen bir sağlayıcı oturumu kullanılabilir. v0.2.0 README dosyası uygulama ve API sunucusu için Bun 1.3+ ister. Güncel main bu gereksinimi 1.4+ olarak yükseltiyor. Bu nedenle klonlanan etiketin README dosyası okunmalıdır. Bir sağlayıcının kendi oturumu, v0.0.15 tarihinden beri API anahtarı yerine kullanılabilir. Geliştirme belgeleri ayrıca sunucuda lsof, openssl ve curl bulunmasını bekler. Intelligence kurulumu için Node üzerinden npx da gerekir. main yerine etiketlenmiş bir sürüm klonlanmalıdır. Bu kadar yeni bir projede main uyarı vermeden değişebilir. Halihazırda bir v0.1.x kurulumu kullanılıyorsa, yükseltme yapılmadan önce v0.2.0 sürüm notları okunmalıdır. Yükseltme, kayıtlı Composio bağlantılarını yeni bir tabloya kopyalar. Daha sonra v0.1.2 sürümüne geri dönülürse yükseltmeden sonra bağlanan hesaplar görünmez.
git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun installIntelligence projesi hazırlanmalıdır. İlk iki komut oturum açar ve projeyi seçer. Ardından yardımcı betik, bu projenin çalışma zamanı anahtarını oluşturur veya yeniden kullanır, openbot Learning container'ını oluşturur ya da mevcut olanı kullanır ve her iki ayarı ortam dosyasına yazar.
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.tsKayıtlı kimlik bilgilerini şifreleyen anahtar oluşturulmalı ve çıktı .env içine KEY_ENCRYPTION_KEY olarak yazılmalıdır. Aynı dosyaya OPENAI_API_KEY eklenmelidir. Kavram kanıtı Bot, OpenAI kullanır. LangGraph Bot için BOT_PROVIDER değeri anthropic veya google olarak ayarlanabilir ve karşılık gelen anahtar eklenebilir. Anahtar yerine model oturumu kullanmak için v0.2.0 .env.example değerini, claude setup-token içindeki belirteci CLAUDE_CODE_OAUTH_TOKEN değerini ve oturum açılmış bir ChatGPT planının yazdığı dosyayı CHATGPT_AUTH_FILE değerini alır. API sunucusu bu değerleri yerleşik agent'ları için okur. compose da bunları seçilen Bot harness'ına aktarır.
openssl rand -base64 32.env açıkken bilgisayar ayarları incelenmelidir. .env.example, COMPUTER_SUPERVISOR_URL ve SUPERVISOR_TOKEN değerlerini boş bırakır ve AGENT_COMPUTER_URL değerini 4100 numaralı porttaki ortak bilgisayara yönlendirir. compose dosyası supervisor'ı içerir. scripts/start.sh, COMPUTER_SUPERVISOR_URL ve SUPERVISOR_TOKEN değerlerini sunucuya sağlayarak bot başına bilgisayar kullanımını varsayılan olarak etkinleştirir. Sunucu manuel olarak başlatılıyorsa her iki değer de ayarlanmalıdır. Supervisor URL'si olmadan tüm botlar aynı tarayıcıyı ve oturum açma bilgilerini paylaşır.
Ardından başlatılmalıdır.
bash scripts/start.shscripts/start.sh Docker servislerini başlatır, veritabanı migration'larını çalıştırır, sunucuyu, rutin worker'ı ve uygulamayı başlatır ve bunların sağlık durumunu denetler. İşlem tamamlandığında uygulama 3010 numaralı porttan, API ise 3001 numaralı porttan yanıt verir. Betik port çakışmalarını bildirir ve zaten çalışmakta olan eşleşen bir servisi durdurmaz. Bu nedenle betiğin iki kez çalıştırılması güvenlidir.
Herhangi bir erişim açmadan önce sunucunun kendisinden denetim yapılmalıdır.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'İlk komuttan alınan 200 yanıtı, uygulamanın istek kabul ettiğini gösterir. İkinci komut, bu portların hangi adreslere bağlandığını gösterir. VPS açısından önemli olan sonuç budur. 127.0.0.1:3001 satırı yalnızca sunucuya özeldir. 0.0.0.0:3001 satırı ise sunucuya ağ üzerinden erişebilen herkesin bu porta ulaşabileceği anlamına gelir.
Tek konteyner imajı
Dağıtım belgeleri ayrıca uygulamayı, API'yi ve Chromium'u barındıran, 3001 numaralı port üzerinden hizmet veren tek bir imaj sunar. Bu imaj, sürüm etiketleriyle birlikte ghcr.io/copilotkit/openbot olarak yayınlanır veya kendi klonunuzdan derleyebilirsiniz.
docker build -t openbot .
docker run -p 127.0.0.1:3001:3001 --env-file .env \
-e EMBEDDED_POSTGRES=on -v openbot-data:/var/lib/postgresql openbotEMBEDDED_POSTGRES=on, konteyner içinde PostgreSQL çalıştırır ve başlangıçta migrasyonları uygular. Adlandırılmış birim (named volume), yeniden dağıtım sonrasında denetim geçmişini korur; bu birim olmadan her yeniden derleme işlemi geçmişi siler. Birimi veri dizininin kendisine değil, üst dizin olan /var/lib/postgresql konumuna bağlayın. Belgeler, veri dizinini bağlamanın kümeyi başlatılmamış durumda bırakabileceği ve uygulamanın 502 hatası döndüreceği konusunda uyarıda bulunur. Eğer DATABASE_URL değerini bunun yerine yönetilen bir veritabanına yönlendirirseniz, üzerinde vector eklentisinin etkinleştirilmiş olması gerekir. RDS, Cloud SQL ve Azure Database gibi yönetilen servisler bu eklentiyi destekler ancak hiçbiri sizin için otomatik olarak etkinleştirmez. Migrasyonlar ayrıca onları çalıştıran rolün eklentinin sahibi olmasını bekler; bu nedenle eklenti farklı bir rol altında oluşturulduysa işlemler must be owner of extension vector hatasıyla durur.
Veritabanı harici olduğunda migrasyonları bir sürüm adımı olarak çalıştırın.
docker run --rm --env-file .env --entrypoint sh openbot \
-c "cd /app/server && bun scripts/migrate.ts"drizzle-kit migrate yerine scripts/migrate.ts kullanın, çünkü drizzle-kit CLI üretim imajında bulunmayan bir geliştirme bağımlılığıdır. --entrypoint sh değerini koruyun, çünkü bu olmadan API migrasyonlar çalışmadan önce başlar.
Bu imaj, tarayıcı portunu kasıtlı olarak yayınlanmamış bırakır. Ayrıca supervisor bileşenini de dışarıda tutar, çünkü supervisor Docker soketine ihtiyaç duyar ve sunucusuz (serverless) platformlar bunu sunmaz. Supervisor olmadan her bot aynı tarayıcıyı ve dolayısıyla aynı oturum bilgilerini paylaşır; bu da bot başına konteyner çalıştırmanın sağladığı izolasyonu ortadan kaldırır. Bu tek konteyner yöntemi, bota asla kendi konteynerini vermeyen yoldur. Eğer bot başına ayrı oturumlar sizin için önemliyse, compose yığınını COMPUTER_SUPERVISOR_URL ve SUPERVISOR_TOKEN ayarlarıyla, bu takası kabul ettiğiniz bir ana makinede çalıştırın. Docker soketiyle iletişim kurabilen bir süreç, ayrıcalıklı bir konteyner başlatabilir; bu nedenle pratikte ana makinede root yetkisine sahiptir. Bu, OpenBot'u kodlama ajanlarına geçici bir VM vermek ile aynı mantık çerçevesinde, kendi makinesinde tutmak için iyi bir nedendir.
OPENBOT_SINGLE_USER neden laptop ayarıdır
.env.example, OPENBOT_SINGLE_USER=true ile birlikte gelir. Bu ayar, her isteği sabit bir administrator hesabından geliyormuş gibi kabul eder ve oturum açma işlemini tamamen devre dışı bırakır. Bir laptop üzerinde bu kolaylık sağlar; çünkü porta erişebilen tek istemci sizsinizdir. Bir VPS üzerinde ise 3010 numaralı porta erişebilen herkes, şifrelenmiş kimlik bilgilerini depolayan ve hesaplarınızda zaten oturum açılmış bir tarayıcıyı yöneten sistemde administrator olur.
Sunucu artık bunun bir bölümünü denetler. OPENBOT_SINGLE_USER=true ayarlıysa ve bir OPENBOT_PUBLIC_URL, OPENBOT_APP_URL veya TRUSTED_ORIGINS girdisi dışarıya yönlendirilmişse sunucu başlatmayı reddeder ve adresi belirtir. Özel bir adres için uyarı vererek başlar. Bu denetim, Docker'ın yayın yaptığı arayüzleri değil, yapılandırmanızdaki URL'leri okur. Bu nedenle bir port internete açık olsa bile varsayılan localhost değerleri denetimden geçer. Bağlama işlemi yine sizin sorumluluğunuzdadır.
Bunu çalıştırmanın iki dürüst yolu vardır. OPENBOT_SINGLE_USER=true değerini koruyun, tüm portları 127.0.0.1 adresine bind edin ve uygulamaya yalnızca bir SSH tüneli veya özel bir ağ arayüzü üzerinden erişin.
ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vpsUygulama daha sonra kendi tarayıcınızda http://localhost:3010 adresinde açılır. Chrome ve Firefox bu adresi güvenli bağlam olarak değerlendirir ve bu adres üzerinden ayarlanan Secure oturum açma çerezlerini saklar. Safari istisnadır: localhost adresini de güvenli bağlam olarak bildirir, ancak 10 November 2026 itibarıyla düz http://localhost üzerinden ayarlanan Secure çerezini hâlâ saklamayı reddeder. Bu, açık durumdaki bir WebKit hatasıdır. Bu nedenle tüneli Chrome veya Firefox'ta açın ya da önüne TLS ekleyin. Canlı ekranın kendisi güvenli bağlam gerektirmez: dağıtım belgelerinde, uygulamanın düz http:// protokolünün kullanılamaz hale getirdiği tarayıcı API'lerinden hiçbirine bağlı olmadığı belirtilir.
Diğer seçenek, tek kullanıcılı modu kapatmak ve gerçek bir kimlik sağlayıcısı yapılandırmaktır. Google, Microsoft Entra, Okta, SAML ve OIDC desteklenir. Google, Entra ve Okta ortamda yapılandırılır. SAML ve OIDC sağlayıcıları ise dağıtım çalışmaya başladıktan sonra Admin, Identity providers altında kaydedilir. Her sağlayıcı için ayrıca en az 32 karakter uzunluğunda BETTER_AUTH_SECRET, OAuth geri çağrıları için genel API temel URL'sine ayarlanmış BETTER_AUTH_URL ve INITIAL_ADMIN_EMAILS gerekir. TRUSTED_ORIGINS zorunlu listede yer almaz. Ancak API'nin kabul ettiği uygulama origin'lerini ve kayıtlı bir OIDC sağlayıcısının discovery belgesindeki her host'u içerir. Ayrıca varsayılan olarak ilk girdisini kullanır. Bu nedenle OPENBOT_APP_URL değerini genel uygulama origin'inize ayarlayın. Sağlayıcı kimlik bilgileri eksiksiz olmalıdır. Yarım yapılandırılmış bir sağlayıcı, açık erişime geri dönmek yerine başlangıç işlemini durdurur.
Hesap ekleme nedeniniz, ekipteki her kişinin kendine ait bir tarayıcı yerine kendine ait bir agent istemesiyse, OneCLI baştan bu kullanım biçimi temel alınarak tasarlanmıştır. Her kişi için sandbox içinde çalışan bir agent bulunur ve model anahtarları tek bir gateway'de tutulur.
Uygulamaya genel erişime açık bir alan adı üzerinden erişilebiliyorsa önüne TLS (transport layer security) konulmalıdır. http:// üzerinden, localhost dışındaki bir adrese sunulan sayfa güvenli bağlam değildir; bu nedenle Secure olarak işaretlenen çerezler kaydedilmez ve oturum açma işlemi OpenBot hatası gibi görünen bir şekilde başarısız olur.
Düşük seviyeli portların güvenlik duvarı ile kısıtlanması
OpenBot'un kendi güvenlik notu, düşük seviyeli servis uç noktalarının tokenlar ile korunduğunu, bunların gizli tutulması gerektiğini ve ağ geçidini (gateway) atlatmak için kullanılmamaları gerektiğini belirtir. Tokenlar ikinci koruma katmanıdır. İlk koruma katmanı ise portun dışarıdan hiçbir şekilde erişilemez olmasıdır.
agent-computer 4100 portunu dinler ve COMPUTER_TOKEN gerektirir. Bot uç noktaları 4200 ve 4201 portlarını, agent harness ise 4202 portunu dinler. Supervisor, ana makinede 4500, container içerisinde ise 4300 portunu dinler ve compose dosyası bunu 127.0.0.1:4500 adresine bağlar. PostgreSQL 5432 portunu dinler. Bunların hiçbiri genel bir arayüzde yer almamalıdır; tek kullanıcılı bir kurulumda uygulama ve API de genel arayüzde bulunmamalıdır.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verboseBurada, güvenlik duvarının yeterli olduğunu varsayan kişilerin düştüğü bir tuzak vardır. Bir container portunu -p 3001:3001 ile dışarı açmak, Docker'ın bir DNAT kuralı yüklemesine neden olur. Bu sayede trafik FORWARD yolunda işlenir ve ufw'nin varsayılan reddetme kuralının geçerli olduğu INPUT zincirinden asla geçmez. ufw status komutu hala Status: active çıktısını verse bile port açık kalır. Yayınlanan portu eşleştirme sırasında -p 127.0.0.1:3001:3001 olarak loopback arayüzüne bağlayın veya compose dosyanızda ana makine adresini ayarlayın. Doğrulamayı ufw status ile değil, ss -ltnp ile yapın. Bu tuzakla ilgili hiçbir şey OpenBot'a özgü değildir; bu nedenle, 90'ların video dükkanı olarak yeniden yapılandırılmış bir Jellyfin kütüphanesi dahil olmak üzere, sunucuda yayınladığınız diğer tüm container'lar için aynı kontrolü çalıştırın.
OpenBot, self-hosted Intelligence ile çevrimdışı çalışabilir
Dağıtımı planlamadan önce bunu netleştirin. OpenBot, kalıcı iş parçacıklarını ve konuşma belleğini barındırılan hizmette veya kendi altyapınızda tutan bir CopilotKit Intelligence projesine bağlıdır. Sabitlenen v0.2.0 sunucusu başlangıçta INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL ve INTELLIGENCE_API_KEY değerlerini doğrular. Bu üç değeri birlikte denetler ve herhangi biri eksikse başlatmayı reddeder. COPILOTKIT_LICENSE_TOKEN isteğe bağlıdır ve yalnızca kendi lisansına sahip self-hosted Intelligence tarafından kullanılır. 10 November 2026 itibarıyla ücretsiz barındırılan Intelligence, kuruluş başına her ay 1,000 etkileşim içerir. Ancak v0.1.0 nedeniyle OpenBot, dağıtımda ücretli bir Intelligence planı bulunmadığında veya OPENBOT_SELF_HOST_BANNER=false ayarlanmadığında self-hosting banner gösterir. Intelligence da self-host edilebilir. Bu nedenle tamamen yerel bir dağıtım mümkündür, ancak quickstart dokümanında gösterilenden daha fazla çalışma gerektirir. Çevrimdışı production dağıtımı için Annual gerekir. Self-hosted pay as you go kullanımı, faturalandırma amacıyla kullanım bildirmek üzere internete bağlanmalıdır. Ücretsiz Developer Edition, yenilenebilir 30-day lisans ile yerel production dışı değerlendirmeyi destekler. Kurulum ve yenileme için internet erişimi gerekir. Yerel Intelligence CLI, anahtarını CPK_INTELLIGENCE_API_KEY olarak yazar. Sabitlenen v0.2.0 sürümü ise yalnızca INTELLIGENCE_API_KEY değerini okur. Bu nedenle bu sürümde değeri ilgili alana kopyalayın. Güncel main, CLI anahtarını doğrudan kabul eder ve bu anahtara öncelik verir.
Model, ikinci bağımlılıktır. Paketle birlikte herhangi bir model gönderilmez. BOT_PROVIDER, LangGraph Bot için openai, anthropic veya google değerlerini kabul eder. OPENAI_BASE_URL ise OpenAI yolunu uyumlu herhangi bir endpoint'e yönlendirir. Kendi donanımınızda token'ları tutmak istiyorsanız LLM'yi self-host etmek için bir VPS üzerinde Ollama çalıştırma seçeneği bu noktada kullanılabilir. Tarayıcı denetimi modelden yüksek kapasite ister. Bu nedenle yerel bir modeli tercih etmeden önce gerçek bir görev üzerinde test edin.
Tek kopyanın ötesine ölçeklendirme
Ağ geçidi, öğe referanslarını bir sayfa anlık görüntüsüne (snapshot) göre çözümler. Bu anlık görüntü artık PostgreSQL içinde tutulduğundan, ikinci bir kopya (replica), ilkinin aldığı anlık görüntü üzerinde işlem yapabilir. Resmi Helm chart varsayılan olarak iki API kopyası çalıştırır ve bir kopyanın hayatta kalması için gereken her şeyi PostgreSQL içinde saklar. Ayrıca gömülü bilgisayarı devre dışı bırakır ve birden fazla kopya varken bir tane daha kurulmasına izin vermez. API pod'u içindeki bir tarayıcı, bir botun oturum bilgilerini tutar; API'yi ölçeklendirmek bu bilgileri çoğaltacaktır. Tekil imaj dikkat edilmesi gereken durumdur, çünkü her kopya kendi tarayıcısını taşır; bu nedenle bir botun oturum bilgileri, kendisine hizmet veren örnekte kalır. Tek bir VPS üzerinde her botun tarayıcısı aynı ana makinede çalışmaya devam eder, bu yüzden sistemi büyütmek için sunucunun kaynaklarını artırmanız gerekir. Botlar arasındaki izolasyon, tıpkı self-hosted agent sandboxes yapısının bir ajanın hatalarını diğerlerinden uzak tutması gibi, bot başına oluşturulan container'lar aracılığıyla sağlanmaya devam eder.
Hata türleri ve karşılaşılacak belirtiler
.env alanını doldurduktan sonra başlangıç işlemi hemen sonlanıyor. Sunucu, herhangi bir hizmet sunmadan önce yapılandırmayı doğrular. Aşağıdaki durumların her biri sessizce düşük performansla çalışmak yerine başlangıç işlemini durdurur: kısmi bir Intelligence bloğu, eksik bir KEY_ENCRYPTION_KEY, istemci kimliği olup sırrı olmayan bir OAuth sağlayıcısı veya genel URL ile birlikte tek kullanıcı modu. İlk hatayı okuyun, yalnızca o alanı düzeltin ve yeniden başlatın.
Yönetilen bir veritabanında migration işlemleri başarısız oluyor. Bunun iki olası nedeni vardır. vector uzantısı etkinleştirilmemiş olabilir ve migration işlemini yürüten rol bu uzantıyı oluşturamıyor olabilir. Bu durumda migration işlemi, PostgreSQL'in tanımadığı bir sütun türüne ulaştığında başarısız olur. Diğer olasılık, uzantının başka bir rol tarafından oluşturulmuş olmasıdır. Bu durumda migration işlemi must be owner of extension vector hatasıyla durur. Uzantıyı migration işlemlerini yürüten rolle oluşturun. Ardından migration adımını yeniden çalıştırın.
Uygulama yükleniyor ancak oturum açma kalıcı olmuyor. Genel bir adreste düz http:// üzerinden hizmet veriyorsunuz. Bu güvenli bir bağlam değildir. Bu nedenle Secure çerezi atılır. Önüne TLS yerleştirin veya tarayıcının localhost görmesi için SSH tünelini kullanın. Tünel üzerinden Chrome veya Firefox kullanın. Safari, düz http://localhost üzerinden ayarlanan Secure çerezlerini hâlâ siliyor.
Ayrı olmalarını beklediğiniz botlar aynı oturum açma bilgilerini kullanıyor. Supervisor kullanılmıyor. Bu nedenle bot başına ayrı bir bilgisayar yok ve tüm botlar AGENT_COMPUTER_URL adresindeki paylaşılan tarayıcıyı kullanıyor. COMPUTER_SUPERVISOR_URL değerinin ayarlandığını ve supervisor'ın Docker socket'e erişebildiğini doğrulayın.
Bir bot durup yardım istiyor. Sistem tasarımı gereği davranış budur. Denetim kaydı computer.help_requested bilgisini kaydeder. Canlı ekran üzerinden kontrolü devralırsınız. Devir işlemi her iki tarafta da kaydedilir.
FAQ
OPENBOT_SINGLE_USER değerinin bir VPS dağıtımında açık bırakılması güvenli midir?
Yalnızca gateway'e internet üzerinden erişilemiyorsa güvenlidir. OPENBOT_SINGLE_USER=true her isteği, oturum açma işlemi olmadan tek ve sabit bir yönetici olarak kabul eder. Bu nedenle porta erişebilen herkes dağıtımın, depolanan kimlik bilgilerinin ve oturum açılmış tarayıcının denetimini ele geçirir. Bu modda, yapılandırılmış bir genel URL veya güvenilen bir origin genel yönlendirmeye sahipse sunucu başlatılmaz. Ancak bu denetim, portlarınızın nasıl yayımlandığını göremez. Her port 127.0.0.1 adresine bağlanıyorsa ve uygulamaya SSH tüneli veya özel bir ağ arayüzü üzerinden erişiliyorsa bu kullanım kabul edilebilir. Genel bir arayüzde bu seçeneği kapatın. Google, Microsoft Entra, Okta veya OIDC'yi BETTER_AUTH_SECRET, BETTER_AUTH_URL ve INITIAL_ADMIN_EMAILS ile birlikte yapılandırın. TRUSTED_ORIGINS değerini genel uygulama origin'iniz olarak ayarlayın.
Bir OpenBot botu için ne kadar RAM gerekir?
Projenin tek bir Bot için yayımladığı değerlere göre arm64 üzerinde tepe bellek kullanımı 0.55 GB'tır. Belgelenen minimum değer 2 GB, önerilen değer ise 4 GB'tır. Birden fazla botun aynı anda çalışması için yayımlanmış bir değer yoktur. Bunun nedeni, her botun kendine ait bir Chromium çalıştırmasıdır. Gerçek bir görev üzerinde bir bot çalıştırın. Bu container'ın bellek kullanımını docker stats içinde okuyun. Gateway ile veritabanının bellek kullanımını ekleyin. Ardından sonucu aynı anda çalışmasını beklediğiniz bot sayısıyla çarpın.
OpenBot'u self-host etmek için CopilotKit hesabına ihtiyacım var mı?
Evet. OpenBot, kalıcı thread'ler ve bellek için bir CopilotKit Intelligence projesine bağlıdır. Sabitlenmiş v0.2.0 sunucusu, Intelligence API URL'si, gateway WebSocket URL'si ve API anahtarı ayarlanmadığında başlatılmaz. 10 November 2026 itibarıyla ücretsiz bir hosted plan kullanılabilir. Annual plan ve yerel model ile self-hosted Intelligence kullanılarak offline production deployment da desteklenir. Ayrıca kendi model erişiminizi sağlamanız gerekir. Bunun yerine bir model API anahtarı veya desteklenen bir provider oturum açma yöntemi kullanabilirsiniz. OpenBot ile birlikte hiçbir model gönderilmez.
Her bot neden tek bir tarayıcıyı paylaşmak yerine kendine ait bir tarayıcı kullanıyor?
Çünkü tarayıcı profili bir kimliktir. Paylaşılan tarayıcı, paylaşılan çerezler ve paylaşılan oturumlar anlamına gelir. Bu nedenle bir hesaba giriş yapan tek bir bot, o hesaba giriş yapmış tüm botlar anlamına gelir. Bot başına kullanılan container'lar her coworker için ayrı bir profil ve ayrı oturum açma bilgileri sağlar. Ancak bunun için COMPUTER_SUPERVISOR_URL değerinin sunucuyu supervisor'a yönlendirmesi gerekir. Bu değer olmadan tüm botlar tek bir tarayıcıyı paylaşır. Bunun bedeli bellek kullanımıdır. Çünkü bot başına bir Chromium çalıştırılması boyutlandırmadaki en büyük tek kalemdir.
OpenBot için güvenlik duvarında hangi portlar açık olmalıdır?
Alt düzey portların hiçbiri açık olmamalıdır. 4100 üzerindeki agent-computer, 4200 ve 4201 üzerindeki bot endpoint'leri, 4202 üzerindeki agent harness, 4500 üzerindeki supervisor ve 5432 üzerindeki PostgreSQL özel ağda kalmalıdır. Proje bu servisleri token'larla korur ve bunların yine de erişilemez durumda tutulmasını ister. Yalnızca kullanıcıların açması gereken portları yayımlayın. -p 3001:3001 ile yayımlanan bir container portunun, ufw default-deny kuralından bağımsız olarak erişilebilir olduğunu unutmayın. Bunun nedeni, Docker'ın DNAT kuralının bu trafiği INPUT yerine FORWARD yoluna yönlendirmesidir.