LiveContext kendi sunucuna nasıl kurulur?
LiveContext CE kurulumu için 8 GB RAM gerektiren yedi konteynerlik Docker yapısını inceleyin. Sürüm sabitleme, Traefik entegrasyonu ve veri yedekleme adımlarını öğrenin.
LiveContext nedir ve çalıştırma maliyeti
LiveContext'i kendi sunucunuzda barındırmak için yaklaşık 8 GB RAM kapasiteli bir VPS gereklidir. LiveContext CE, otomasyon süreçlerinin içinde yapay zeka ajanlarını çalıştıran, kaynak koduna erişilebilen bir otomasyon platformudur. Yazılım, Java tabanlı bir arka uç etrafında yapılandırılmış yedi container içeren bir Docker Compose yığını olarak dağıtılır; bunlardan biri kurulum sonrası sonlanan tek seferlik bir iş sürecidir. Satıcının kendi kendine barındırma belgelerinde minimum 4 GB, önerilen ise 8 GB RAM belirtilmektedir. npm başlatıcısının README dosyası artık minimum 6 GB gereksinimi göstermekte olup, compose dosyası bu bellek kullanımının nereye gittiğini açıklamaktadır.
Proje, GitHub üzerinde livecontext-ai/livecontext-ce olarak AGPL-3.0 lisansıyla yayımlanmıştı ancak CE sürümü artık AGPL lisansına sahip değildir. Mevcut sürümle birlikte gelen lisans, LiveContext Sürdürülebilir Kullanım Lisansı 1.1'dir. Bu, kaynak koduna erişilebilen bir lisans olup CE sürümünü kendi işletmenizde üretim ortamı dahil olmak üzere çalıştırmanıza ve değiştirmenize izin verir; ancak LiveContext'in ücretli sürümleriyle rekabet edecek şekilde üçüncü taraflara barındırılan veya gömülü bir hizmet olarak sunulmasını yasaklar. Satıcının npm başlatıcısı bu değişikliği göstermektedir: livecontext@0.2.11, AGPL-3.0-only olarak bildirilmiş olup livecontext@0.3.8 ilgili lisans dosyasına işaret etmektedir. 13 Ekim 2026 itibarıyla GitHub deposu ve livecontext-ai organizasyonu 404 hatası vermektedir. Satıcı belgeleri hala depoyu klonlamanızı önerse de, bu kılavuz sürüm dosyalarını npm paketinden almaktadır. Mevcut sürüm, 9 Ekim 2026 tarihinde yayımlanan v0.3.8 sürümüdür. Her LiveContext imajı yalnızca linux/amd64 mimarisi için derlenmiştir; bu durum uygun fiyatlı Arm planlarının kullanımını imkansız kılar. Bu kılavuz, ilgili etiketi sabitlemekte, yığını bir reverse proxy arkasına almakta ve satıcının yedekleme tavsiyelerini uygulanabilir komutlara dönüştürmektedir.
LiveContext'i self-host etmeden önce VPS boyutlandırması
Dağıtılan compose dosyasındaki servislerin çoğu açık bir bellek sınırına sahiptir, bu sayede sunucuyu kiralamadan önce boyutlandırma yapabilirsiniz. İki servis hariçtir: tek seferlik minio-init işi ve frontend. Bunlar, ölçülen kullanım değil, v0.3.8 compose dosyasına yazılan sınırlardır.
Bu grafiğin arkasındaki veriler
[
{
"label": "livecontext (backend)",
"memory_limit_mb": 2048
},
{
"label": "bridge",
"memory_limit_mb": 512
},
{
"label": "postgres",
"memory_limit_mb": 512
},
{
"label": "redis",
"memory_limit_mb": 384
},
{
"label": "minio",
"memory_limit_mb": 256
},
{
"label": "websearch (optional)",
"memory_limit_mb": 2048
},
{
"label": "searxng (optional)",
"memory_limit_mb": 512
},
{
"label": "renderer (optional)",
"memory_limit_mb": 1024
}
]Yalnızca backend 2048 MB ile sınırlandırılmıştır. Bu sınır, heap alanı 1 GiB olarak ayarlanmış (-Xmx1024m ve ZGC ile) bir Java 21 sürecinin üzerindedir; compose dosyasındaki yorum satırı, heap alanının bu tam GiB değerine ulaştığını ve üzerine JVM'in kendi ek yükünün bindiğini belirtir. Sınırları olan beş temel servis toplamda yaklaşık 3,6 GB yer kaplar; frontend ise herhangi bir sınıra sahip değildir, bu nedenle Node'un talep ettiği kadarını kullanır. 4 GB'lık bir VPS üzerinde bu sınırlar, frontend, çekirdek ve sayfa önbelleği için yalnızca birkaç yüz MB boş alan bırakır. Başlatıcıya ait README dosyasının, self-hosting dokümanlarında hala 4 GB yazmasına rağmen minimum gereksinimi 6 GB olarak güncellemesinin nedeni budur.
Sunucuyu 8 GB'a çıkaran unsurlar isteğe bağlı profillerdir. Tarayıcı aracısı (browser agent) profili, bir SearXNG arama örneğinin yanında 2048 MB ile sınırlandırılmış bir Chromium container'ı ekler; oluşturucu (renderer) profili ise ekran görüntüleri ve PDF'ler için ek 1024 MB daha ekler. Profilleri etkinleştirmediğiniz sürece hiçbiri başlamaz, bu yüzden ihtiyaç duyana kadar her ikisini de kapalı tutun. Chromium container'ı, npm paketinde bulunmayan bir websearch-service dizininden yerel olarak derlenir; bu nedenle 13 Ekim 2026 itibarıyla GitHub deposuna erişilemediğinde, tarayıcı aracısı profili yayınlanan dosyalardan derlenemez. Oluşturucu ise yayınlanmış bir imaj kullandığı için bu durumdan etkilenmez. SearXNG container'ı, aracının arama backend'i olarak görev yapmak üzere mevcuttur; bu nedenle döndürdüğü sayfalar istemlerinize güvenilmeyen metin olarak ulaşır. Bu, bir yapay zeka aracısına SearXNG web araması verme konusunda detaylıca işlenen güven sınırıdır.
Eğer halihazırda n8n çalıştırıyorsanız, onu eklemek yerine değiştirmeyi planlayın. Docker ve HTTPS ile VPS üzerinde n8n çalıştırma rehberimizdeki yığın, Postgres'in yanında tek bir Node sürecinden oluşur ve küçük bir sunucuda rahatça çalışır. LiveContext, yalnızca backend'i için o yığının tamamından daha fazla kaynak ayırır. 8 GB'lık tek bir VPS üzerinde iki otomasyon platformu, her ikisi de aynı dakika içinde bir iş çalıştırana kadar sorunsuz sığacaktır. Eğer bir sunucuyu paylaştıracaksanız, Docker Compose'da bellek sınırlarını ayarlama konulu yazımızdaki yöntemi kullanarak diğer her şeye de açık sınırlar koyun; böylece kontrolden çıkan bir iş akışı makineyi beraberinde çökertemez.
LiveContext kurulumunu Docker Compose ile belirli bir sürüme sabitleyerek gerçekleştirme
Docker Engine 24 veya daha yeni bir sürüm ve Compose v2 yüklü, temiz bir Ubuntu 24.04 VPS ile başlayın. Eğer Docker henüz yüklü değilse, önce VPS için Docker Compose temelleri rehberimizi takip edin ve ardından buraya dönün.
Başlatıcı README dosyası, tek satırlık bir komut olarak npx livecontext@latest kullanımını önerir. Bu yöntem dizüstü bilgisayarlar için uygundur ancak başlatıcı, her çalıştırıldığında compose dosyasını yeniden kopyalar ve belirttiği imajlar latest etiketiyle işaretlenmiştir. Bir sunucuda, compose dosyasının kontrolünüz altındaki bir dizinde durmasını ve belirli bir sürüme sabitlenmesini istersiniz; böylece yükseltme işlemi, farklarını (diff) görebileceğiniz bir dosya değişikliğine dönüşür. Tedarikçi belgeleri bunun için hala GitHub deposunun bir git clone işlemini tarif etmektedir, ancak bu depo 13 Ekim 2026 itibarıyla 404 hatası döndürmektedir. Bu nedenle, compose dosyasını ve örnek env dosyasını, istediğiniz sürümün npm paketinden alın.
sudo apt update && sudo apt install -y npm
npm view livecontext version
mkdir -p ~/livecontext-ce/docker ~/livecontext-ce/catalog-seeds
cd ~/livecontext-ce
npm pack livecontext@0.3.8
tar xzf livecontext-0.3.8.tgz
cp package/assets/docker-compose.yml .
cp package/assets/.env.example docker/.env.ce
chmod 600 docker/.env.ceCompose dosyası, ./catalog-seeds dizinini backend içerisine bind-mount yöntemiyle bağlar; yukarıda bu dizinin oluşturulmasının nedeni budur. npm başlatıcısı, başlangıçta indirdiği bir model kataloğu paketiyle bu dizini doldurur; yığın (stack) ise boş bir dizinle başlar.
npm paketindeki compose dosyası, başlık kısmındaki yorum satırı etiketin sürüme sabitlendiğini belirtse de, her LiveContext imajını latest etiketiyle (örneğin ghcr.io/livecontext-ai/livecontext-ce:latest) adlandırır. İlk başlatmadan önce etiketi kendiniz sabitleyin. Tedarikçi, aynı sürüm etiketlerini Docker Hub üzerinde livecontext ad alanı altında yayınlamaktadır. 13 Ekim 2026 itibarıyla backend, frontend, bridge ve renderer imajları için v0.3.8 listelenmiştir; bu nedenle dört imajı da bu sürüme yönlendirin:
sed -i -E 's#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v0.3.8#' docker-compose.yml
grep -n 'image:' docker-compose.ymlCompose dosyasını imajlarla aynı sürümden almak, ikisinin uyumlu kalmasını sağlar; çünkü v0.3.8 için hazırlanan compose dosyası bu imajlara göre yazılmıştır. Etiketleri latest üzerinde bırakmayın. Bir latest etiketi siz fark etmeden değişebilir ve backend her başlangıçta veritabanı migrasyonlarını çalıştırır; bu nedenle yanlışlıkla yapılan bir "pull" işlemi, şemanızı gece saat 03:00'te, bir geri yükleme (restore) dışında geri dönüşü olmayan bir şekilde ileri taşıyabilir.
İlk başlatmadan önce docker/.env.ce dosyasını düzenleyin (bir sonraki bölüm nelerin değiştirilmesi gerektiğini listeler) ve ardından yığını ayağa kaldırın.
docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce psBu rehberdeki her compose komutunda aynı --env-file bayrağını kullanın. Compose, her çağrıda bu dosyayı yeniden okur; bu bayrağın kullanılmadığı bir komut, compose dosyasına gömülü varsayılan ayarlara geri döner ve yapılandırdığınızdan farklı portlar yayınlayabilir.
Backend sağlık kontrolü (healthcheck) 120 saniyelik bir start_period değerine sahiptir ve /actuator/health adresini sorgular. Bu nedenle, şema migrasyonları ve araç kaydı işlemleri devam ederken, docker compose ps yaklaşık ilk iki dakika boyunca livecontext servisini health: starting olarak raporlar. Bu normal bir durumdur. Sunucudan hızlı bir kontrol:
curl -s localhost:8080/actuator/healthBu komut {"status":"UP"} çıktısını vermelidir. Çıktıyı aldığınızda, 3000 numaralı port üzerinden web arayüzünü açın. Oluşturduğunuz ilk hesap yönetici (admin) olur ve bir yönetici tarafından tekrar açılmadığı sürece genel kayıtlar kapatılır; bu nedenle port başkaları tarafından erişilebilir hale gelmeden önce kendi hesabınızı oluşturun. Bu, 3000 numaralı portu ilk günden internete açmamanız için en önemli nedendir.
Değiştirmeniz gereken env değerleri
Örnek dosya, yığının bir dizüstü bilgisayarda çalışabilmesi için işlevsel varsayılanlarla gelir. Bunların birçoğu halka açık bir sunucuda güvensizdir.
DB_PASSWORD=<random>
MINIO_ROOT_USER=<not minioadmin>
MINIO_ROOT_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_SALT=<random>
ANTHROPIC_API_KEY=sk-ant-...
FRONTEND_PORT=3000
BACKEND_PORT=8080
PUBLIC_BASE_URL=https://lc.example.com
GATEWAY_PUBLIC_URL=https://lc-api.example.comHer rastgele değeri openssl rand -base64 32 ile oluşturun. Sorun yaratabilecek olanlara dair notlar:
DB_PASSWORDveMINIO_ROOT_PASSWORD,postgresveminioadminolarak gelir. Compose dosyası,POSTGRES_PASSWORDolarak Postgres'eDB_PASSWORDdeğerini iletir. Her iki veritabanı portu da ana makineye yayınlanmaz, bu nedenle doğrudan dışarıya açık değildir; ancak daha sonra aynı ağa bağladığınız herhangi bir container, belgelenmiş varsayılan değerlerle her ikisine de erişebilir.CREDENTIAL_ENCRYPTION_PASSWORDveCREDENTIAL_ENCRYPTION_SALTyorum satırı olarak gelir ve boş bırakıldıklarında ilk açılışta otomatik oluşturulurlar. Bunları kendiniz ayarlayın. İş akışlarınızın depoladığı kimlik bilgileri bu çift ile şifrelenir; bu nedenle aynı parola ve salt değeri olmadan yeni bir sunucuya geri yüklenen veritabanı yedeği, içeriği okunamayan kimlik bilgisi satırları oluşturur. Bunları bir kez ayarlayın ve ardındandocker/.env.cedosyasını yedeğin bir parçası olarak saklayın.FRONTEND_PORTveBACKEND_PORT, port eşlemelerinde${FRONTEND_PORT:-3000}:3000ve${BACKEND_PORT:-8080}:8080olarak yer değiştirir. Örnek env dosyası, her ikisini de# FRONTEND_PORT=3000ve# BACKEND_PORT=8080olarak yorum satırı şeklinde sunar; bu nedenle bir satırın yorumunu kaldırıp geçersiz kılmadığınız sürece 3000 ve 8080 varsayılanları geçerli olur.PUBLIC_BASE_URL, web arayüzünün tarayıcıdan erişilen adresidir ve örnek dosya, sunucu kurulumlarında bunuGATEWAY_PUBLIC_URLile birlikte ayarlamanızı ister. Her ikisini de sonunda eğik çizgi (slash) olmadan yazın, çünkü örnek dosya bunun OAuth geri çağırmalarını (callbacks) bozacağı konusunda uyarıda bulunur.GATEWAY_PUBLIC_URL, arka ucun (backend) tarayıcıdan erişilen kökenidir (origin). Bir reverse proxy dahil olduğunda önem kazanır. Bir sonraki bölüme bakın.- Model anahtarları (
ANTHROPIC_API_KEY,OPENAI_API_KEY,GOOGLE_API_KEYve isteğe bağlı olarakMISTRAL_API_KEYveyaDEEPSEEK_API_KEY) burada düz metin olarak bulunur. Yalnızca fiilen kullandığınız sağlayıcıyı doldurun.
Yedi container ne işe yarar
postgres,livecontextisimli veritabanını barındıranlivecontext-dbcontainer'ı olarakpgvector/pgvector:pg16çalıştırır. Gömülü arama (embedding search) için pgvector eklentisi gereklidir, bu nedenle standart birpostgres:16imajı yeterli olmayacaktır.redis,appendonly yesve--maxmemory-policy noevictionyapılandırmasıylaredis:7-alpineçalıştırır. Bu politika bilinçli olarak seçilmiştir: Redis burada kuyruk ve çalışma durumunu tutar; bellek sınırına ulaştığında anahtarları sessizce silmek yerine yazma işlemini yapan tarafa hata döndürür. Görünür bir hata, kaybolan işlerden daha iyidir.minio, iş akışları boyunca taşınan dosyalar için S3 uyumlu nesne deposudur.minio-init, başlangıçtamc mb myminio/workflow-files --ignore-existingçalıştıran, bucket'ı oluşturan ve ardından sonlanan tek seferlik bir container'dır.docker compose psiçerisindeminio-initdeğeriniexited (0)olarak görmek sağlıklı durumdur.bridge, CLI adaptörlerini ve MCP (model context protocol) araçlarını barındırır. Docker ağı içerisinde 8093 portunu dinler ve ana makineye (host) yayınlanmaz.livecontext, 8080 portunda çalışan Java 21 tabanlı bir monolitik backend'dir. İş akışı motorunu, zamanlayıcıları ve aracıları (agents) çalıştırır.frontend, 3000 portundaki Next.js web arayüzüdür. Sadece bu son ikisi ana makineye yayınlanır.
Veri durumu yedi adet isimlendirilmiş volume içerisinde tutulur: Postgres için livecontext_data, ayrıca livecontext_redis, livecontext_minio, livecontext_keys, livecontext_bridge_secret, livecontext_cli_home ve livecontext_logs. Compose, bu volume'leri compose dosyasında livecontext-ce olarak belirlenen proje ismiyle ön ekler; dolayısıyla diskteki gerçek volume ismi livecontext-ce_livecontext_minio gibi bir şey olur. npm başlatıcısı bu ismi -p livecontext ile geçersiz kılar, bu yüzden bir zamanlar npx livecontext çalıştıran bir makine, livecontext_ ön ekli ikinci bir set daha barındırır. Herhangi bir yedekleme betiği yazmadan önce docker volume ls komutunu çalıştırın ve tam isimleri kopyalayın.
docker compose down -v, yedi volume'ün tamamını siler. Tedarikçi belgeleri, oluşturduğunuz tüm iş akışlarını kaybetmenin en hızlı yolu olduğu için bu komutun asla çalıştırılmaması gerektiğini belirtir. Aradaki tek fark-vifadesidir.
Port 3000'i dışarı açmak yerine Traefik arkasına alın
3000 ve 8080 numaralı portları herkese açık bir VPS üzerinde yayınlamak, uygulamayı TLS (taşıma katmanı güvenliği) olmadan ve yönetici kaydı önünde hiçbir engel bulunmadan dış dünyaya açar. Docker, yayınlanan portlar için ufw tarafından yönetilen zincirin önüne kendi iptables kurallarını eklediğinden, sadece bir ufw kuralı yeterli değildir; bu nedenle 0.0.0.0 adresine yayınlanan bir port, ufw portu reddettiğini söylese bile erişilebilir kalır.
Temiz çözüm, hiçbir portu yayınlamamak ve proxy'nin container'lara paylaşımlı bir Docker ağı üzerinden erişmesini sağlamaktır. docker-compose.yml dosyasının yanına docker-compose.override.yml dosyasını oluşturun:
services:
frontend:
ports: !override []
networks:
- default
- proxy
livecontext:
ports: !override []
networks:
- default
- proxy
networks:
proxy:
external: trueBunun çalışıp çalışmayacağına iki detay karar verir. !override, port listesini birleştirmek yerine tamamen değiştirir; bu da Compose v2.24 veya daha yeni bir sürüm gerektirir: docker compose version ile sürümü kontrol edin, çünkü daha eski bir Compose sürümünde iki liste birleşir ve portlar yayınlanmaya devam eder. Ayrıca default, her networks listesinde kalmalıdır; çünkü herhangi bir ağ tanımlamak varsayılan ağı devre dışı bırakır, bu yüzden onu listeden çıkarmak backend'in Postgres ve Redis ile, frontend'in ise backend ile olan bağlantısını keser. Herhangi bir işlem başlatmadan önce birleştirilmiş sonucu doğrulayın:
docker compose --env-file docker/.env.ce configRouter'lar, sertifika çözümleyici ve HTTP'den HTTPS'ye yönlendirme, diğer tüm uygulamalarla aynıdır; bu nedenle yeni bir TLS yapılandırması yazmak yerine tek bir VPS üzerinde birden fazla uygulama çalıştırmaya yönelik Traefik reverse proxy rehberimizi takip edin. Bir alan adını 3000 numaralı port üzerinden frontend adresine, ikincisini ise 8080 numaralı port üzerinden livecontext adresine yönlendirin.
İkinci alan adı isteğe bağlı değildir. Web arayüzü, backend'i tarayıcı üzerinden çağırır; bu nedenle backend'in, tarayıcının ulaşabileceği kendi origin adresine ihtiyacı vardır. docker/.env.ce içindeki GATEWAY_PUBLIC_URL değerini bu backend URL'sine (örneğin https://lc-api.example.com), PUBLIC_BASE_URL değerini ise frontend URL'sine ayarlayın. Bunu atlarsanız sayfa normal şekilde yüklenir ancak her işlem başarısız olur; çünkü arayüz, backend origin adresini sayfayı açtığınız adresten çözümler ve proxy'nizin asla yayınlamadığı bir portu çağırmaya çalışır.
Kayıt sayfası, sayfaya ilk ulaşan herkese açık olduğundan, frontend router üzerinde bir kimlik doğrulama katmanı eklemek mantıklıdır. Böylece kimse proxy seviyesinde kimlik doğrulaması yapmadan o sayfayı göremez; kendi SSO katmanınız olarak Authentik çalıştırmak, aynı Traefik kurulumunun üzerine tam olarak bunu ekler.
Model anahtarının konumu ve boşta duran bir örneğin neden maliyet oluşturduğu
Agent'lar burada otomasyonun içinde çalışır. Bu durum, düz bir workflow aracına kıyasla maliyet yapısını değiştirir. Provider key, docker/.env.ce içinde ANTHROPIC_API_KEY veya OPENAI_API_KEY olarak tutulur. Backend ve bridge bu anahtarı başlangıçta okur. Anahtar, instance'ın tamamı için geçerlidir. Kullanıcı bazında kapsamlandırılmaz. Instance'ınızda hesabı bulunan ve agent oluşturabilen herkes bu anahtarı kullanarak harcama yapabilir. Ayrıca kayıt olan ilk kişi admin olur. İhtiyaç, kişi bazında agent'lar ve harcamaları belirli bir çalışma arkadaşına gerçekten atfedebilmekse, kişi başına bir agent çalıştırma altyapısı olarak OneCLI'yi self-host etmek, aynı key sorununu farklı bir yöntemle çözer. Her model key'ini, çağrıyı kimin yaptığını bilen bir gateway arkasına yerleştirir.
Üç alışkanlık, fatura tutarını öngörülebilir kılar. Bu VPS için ayrı bir sağlayıcı anahtarı oluşturun; böylece diğer hiçbir şeye dokunmadan bu anahtarı iptal edebilirsiniz. Sağlayıcı konsolunda katı bir harcama sınırı belirleyin, çünkü güvence altına aldığınız makinenin dışındaki tek limit budur. Ardından, LiveContext tarafından sunulan ajan bazlı kredi bütçelerini ve ajan bazlı metrikleri kullanın; böylece tek bir döngü, siz fark etmeden anahtarın bakiyesini tüketemez.
Bir ajan zamanlanmış bir görevde (schedule) tanımlandığında, boşta durma maliyeti sıfır değildir. Bir zamanlayıcı tetikleyicisi, birinin izleyip izlemediğine bakılmaksızın çalışır ve her tetiklenme token harcar. Beş dakikalık bir zamanlama günde 288 çalıştırma demektir; bir sayfayı okuyup hiçbir şey yapmamaya karar veren bir ajan bile sayfa okuma maliyetini öder. İlk ajanlarınızı bir webhook veya sohbet tetikleyicisi üzerine kurun, bir hafta boyunca gerçek harcamayı izleyin ve çalıştırma başına maliyeti öğrendikten sonra zamanlamaya geçin.
Postgres ve nesne deposunu yedekleme
İki veri deposunun yanı sıra sırları barındıran iki yer daha mevcuttur: env dosyası ve satıcı belgelerinde yedeklenmesi gereken birimler arasında listelenen livecontext_keys birimi. Bunlardan herhangi birinin kaybedilmesi, örneğinizin kaybına yol açar. Veritabanı satırı döküldükten sonra dosyanın üzerine yazılmasını önlemek için arka uç durdurulmuş haldeyken veritabanını ve bucket'ı aynı zaman aralığında yedekleyin.
cd ~/livecontext-ce
mkdir -p ~/backups
docker compose --env-file docker/.env.ce stop livecontext frontend
docker compose --env-file docker/.env.ce exec -T postgres \
pg_dump -U postgres -d livecontext --clean --if-exists \
| gzip > ~/backups/livecontext-db-$(date +%F).sql.gzEğer değiştirdiyseniz, postgres yerine DB_USERNAME olarak ayarladığınız değeri kullanın. Ardından, docker volume ls çıktısında yazan önekli isimleri kullanarak nesne deposunu ve anahtar birimlerini kopyalayın:
docker run --rm \
-v livecontext-ce_livecontext_minio:/data \
-v ~/backups:/backup \
alpine tar czf /backup/livecontext-minio-$(date +%F).tgz -C /data .
docker run --rm \
-v livecontext-ce_livecontext_keys:/data \
-v ~/backups:/backup \
alpine tar czf /backup/livecontext-keys-$(date +%F).tgz -C /data .
docker compose --env-file docker/.env.ce start livecontext frontend
cp docker/.env.ce ~/backups/env.ce.$(date +%F)Yedeğe güvenmeden önce boş olmadığını kontrol edin: gunzip -c ~/backups/livecontext-db-*.sql.gz | head -20, tek satırlık bir hata mesajı yerine CREATE TABLE ve DROP TABLE ifadelerini göstermelidir. Daha sonra, docker-compose.yml ve geçersiz kılma (override) dosyanızla birlikte dört dosyanın tamamını sunucudan dışarı kopyalayın. Yalnızca koruduğu makinede barınan bir yedek, yedek sayılmaz.
Yeni bir sunucuya geri yükleme yapmak için aynı etiketi (tag) kurun, kimlik bilgisi şifreleme parolası ve tuz (salt) değerlerinin eşleşmesi için kaydedilen docker/.env.ce dosyasını geri koyun, birimlerin oluşması için yığını bir kez başlatın, arka ucu durdurun, anahtar arşivini alındığı yöntemle anahtar biriminin içine açın ve ardından dökümü yükleyin:
gunzip -c livecontext-db-2026-08-10.sql.gz \
| docker compose --env-file docker/.env.ce exec -T postgres psql -U postgres -d livecontextYükseltmeler ve bir şeyler ters gittiğinde geri dönüş
Her seferinde önce bir yedek alın. Backend, başlatma sırasında şema migrasyonlarını uygular ve migrasyonlar yalnızca ileriye doğru çalışır; bu nedenle hatalı bir yükseltmeden sonra eski etikete geri dönmek, eski kodun yeni bir şema üzerinde çalışmasına neden olur. Geri alma işlemi, yedeğin geri yüklenmesi anlamına gelir; bu yüzden yedekleme ilk sırada yer alır.
cd ~/livecontext-ce
npm view livecontext version
TAG=0.3.8
npm pack "livecontext@$TAG"
rm -rf package && tar xzf "livecontext-$TAG.tgz"
cp docker-compose.yml docker-compose.yml.prev
cp package/assets/docker-compose.yml .
sed -i -E "s#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v$TAG#" docker-compose.yml
diff docker-compose.yml.prev docker-compose.yml
docker compose --env-file docker/.env.ce pull
docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce logs -f livecontextTAG değerini ikinci komutun yazdırdığı sürüme ayarlayın. Backend günlüğünü, sağlık kontrolü uç noktası tekrar yanıt verene kadar izleyin. docker-compose.override.yml dosyanız paketin bir parçası değildir, bu nedenle yeni compose dosyasını kopyalamak onu yerinde bırakır; ancak diff komutunun yazdırdığı farkı mutlaka okuyun. Çünkü yeni veya yeniden adlandırılmış bir servis, geçersiz kılma ayarlarınızı herhangi bir hata mesajı vermeden işlevsiz bırakabilir. Yeni ayarlar oraya eklendiği için docker/.env.ce dosyasını package/assets/.env.example ile karşılaştırmayı da ihmal etmeyin.
Hata modları ve karşılaşacağınız dizgeler
Bir container sürekli yeniden başlatılıyor ve docker compose ps komutu exited (137) çıktısını veriyor. Bu, çekirdeğin bellek yetersizliği nedeniyle süreci sonlandırdığı (OOM killer) anlamına gelir ve docker inspect livecontext-app komutu durum bloğunda "OOMKilled": true ifadesiyle bunu doğrular. Backend servisi 2048M sınırına ulaşmıştır veya ana makinenin belleği tükenmiştir. Herhangi bir sınırı yükseltmeden önce free -m değerini kontrol edin; boş belleği olmayan bir ana makinede container sınırını artırmak, yalnızca sonlandırma işleminin başka bir container üzerinde gerçekleşmesine neden olur.
İmaj çekme işlemi no matching manifest for linux/arm64/v8 in the manifest list entries hatasıyla başarısız oluyor. İmajlar yalnızca linux/amd64 mimarisi için yayınlanmıştır. Bir Arm VPS, yayınlanan imajlarla bu yığını çalıştıramaz; QEMU üzerinden emülasyon ise bir JVM ve Chromium için oldukça yavaştır. x86 tabanlı bir plana geçiş yapın.
Bind for 0.0.0.0:3000 failed: port is already allocated. Ana makinede başka bir servis ilgili portu zaten kullanıyor. docker/.env.ce dosyasında FRONTEND_PORT değerini ayarlayın veya yukarıdaki geçersiz kılma (override) yöntemini uygulayarak hiçbir portu dışarıya açmayın.
Arayüz çalışıyor ancak proxy ekledikten sonra giriş isteği başarısız oluyor. Tarayıcı, backend servisine proxy'nizin hizmet vermediği bir kaynaktan (origin) çağrı yapıyor. Tarayıcının ağ (network) sekmesini açın ve başarısız olan isteğin host adresini inceleyin. GATEWAY_PUBLIC_URL değerini genel backend URL'si olarak ayarlayın ve frontend container'ını yeniden oluşturun; çünkü bu değer yalnızca başlangıçta okunur.
Her şey sağlıklı görünüyor ancak iş akışında yüklenen dosyalar kayboluyor. minio-init komutunun sıfır olmayan bir kod yerine exited (0) çıktısını verdiğinden emin olun. Eğer workflow-files bucket'ı oluşturulmadıysa, backend servisi nesneleri kaydedecek bir yere sahip değildir.
LiveContext veya n8n seçimi
Ajanın odak noktası olduğu durumlarda LiveContext'i seçin: Modelin otomasyonu oluşturmasını ve çalıştırmasını istiyorsanız ve bunun bedeli olarak 8 GB RAM kapasiteli bir sunucu ile Java tabanlı bir servisi kabul ediyorsanız bu doğru tercihtir. Deterministik iş akışları, geniş bir düğüm kütüphanesi ve diğer servislerle aynı VPS üzerinde barındırılabilecek kadar düşük bir kaynak kullanımı istiyorsanız n8n'i seçin. Lisanslar artık bu ikisini birbirinden ayırmıyor. LiveContext CE, AGPL-3.0 lisansından, n8n'in Sürdürülebilir Kullanım Lisansı ile aynı adil kod ailesine mensup, kaynak kodu erişilebilir bir lisans olan LiveContext Sürdürülebilir Kullanım Lisansı 1.1'e geçiş yaptı; bu nedenle her ikisini de şirket dışındaki birine sunmadan önce barındırma kısıtlamalarını okuyun. Kendi sunucunuzda barındırdığınız n8n sürümü de bazı özellikleri ücretli müşterilere saklar, bu yüzden bir ekip iş akışı oluşturmadan önce n8n'in hangi bölümlerinin ücretsiz olduğunu ve hangilerinin lisans anahtarı gerektirdiğini kontrol edin. Buradaki sürüm numaraları yenidir, v0.3.8 13 Ekim 2026 itibarıyla 0.3 serisi 22 Eylül ile 9 Ekim 2026 arasında dokuz sürüm yayınlamıştır; bu nedenle sürümünüzü sabitleyin ve her yükseltme öncesinde nelerin değiştiğini inceleyin. Bu iki konum arasında yer alan araçlar da dahil olmak üzere daha geniş bir yelpaze için, sadece bu ikisinin karşılaştırmasını okumak yerine kendi sunucunuzda barındırabileceğiniz n8n alternatifleri özetimize göz atın.
FAQ
Self-hosted LiveContext ne kadar RAM gerektirir?
8 GB RAM planlayın. Üreticinin self-hosting belgelerinde minimum 4 GB, önerilen ise 8 GB olarak belirtilmiştir; başlatıcının README dosyası artık minimum 6 GB demektedir. Sunulan compose dosyası bunun nedenini açıklar: yalnızca backend servisi 2048 MB ile sınırlandırılmıştır ve limitli beş temel servis, sınırsız frontend container'ı hariç toplamda yaklaşık 3.6 GB yer kaplar. Tarayıcı aracısı profilini etkinleştirmek, Chromium ve SearXNG container'ı için ek 2048 MB gerektirir; bu noktada 8 GB artık isteğe bağlı olmaktan çıkar.
LiveContext'i Arm tabanlı bir VPS üzerinde çalıştırabilir miyim?
Hayır. v0.3.8 için yayınlanan her LiveContext imajı linux/amd64 mimarisi için derlenmiştir; bu nedenle Arm tabanlı bir planda docker compose up, no matching manifest for linux/arm64/v8 in the manifest list entries hatası ile çekme aşamasında başarısız olur. QEMU emülasyonu altında çalıştırmak teorik olarak mümkün olsa da, JVM tabanlı bir iş yükü için pratikte kullanılamaz. x86 tabanlı bir plan seçin.
Model API anahtarımı nereye koymalıyım?
İlk başlatmadan önce docker/.env.ce içerisine, ANTHROPIC_API_KEY, OPENAI_API_KEY veya GOOGLE_API_KEY olarak ekleyin. Backend ve bridge servisleri bu anahtarı başlangıçta okur ve anahtar, tek bir kullanıcı yerine tüm instance için geçerli olur. Dosyayı 600 modunda tutun, yalnızca bu sunucu için oluşturulmuş bir anahtar kullanın (böylece gerektiğinde anahtarı tek başına iptal edebilirsiniz) ve sağlayıcı konsolunda bir harcama limiti belirleyin; çünkü bu limit makinenin dışındaki tek sınırlamadır.
LiveContext yedeğini nasıl alırım?
Dört öğe gereklidir: livecontext veritabanının bir pg_dump yedeği, MinIO biriminin bir kopyası, livecontext_keys biriminin bir kopyası ve docker/.env.ce dosyası. Veritabanı ve nesne deposunun birbiriyle uyumlu olması için dump alırken ve birim kopyalarını oluştururken livecontext ve frontend servislerini durdurun. Env dosyası önemlidir çünkü iş akışlarınızda saklanan kimlik bilgileri CREDENTIAL_ENCRYPTION_PASSWORD ve CREDENTIAL_ENCRYPTION_SALT ile şifrelenmiştir; bu değerler olmadan yapılan bir geri yükleme, yeni sunucuda hiçbir şeyin okuyamayacağı kimlik bilgisi satırlarına neden olur.
Backend neden açılıştan sonra dakikalarca health: starting durumunda bekler?
Compose healthcheck ayarı start_period: 120s değerini belirler ve /actuator/health adresini sorgular; bu nedenle şema migrasyonları ve araç kaydı devam ederken Docker servisi "başlıyor" olarak raporlar. İlk açılışta iki ila üç dakika bekleme süresi normaldir. Eğer servis hiçbir zaman sağlıklı duruma geçmezse docker compose logs -f livecontext dosyasını inceleyin. Migrasyon adımında takılan bir yığın, genellikle daha yeni bir sürüme ait bir veritabanı birimine işaret ediyordur.