İçeriğe atla

Ön sürüm belgeler sitesini görüntülüyorsunuzBuradaki içerik test amaçlıdır ve canlı belgelerden farklı olabilir.

Canlı belgelere git

Kendi Sunucunuzda Barındırmaya Genel Bakış

Kendi örneğinizi çalıştırın; her gizli mesaj, hesap ve günlük satırı sizin kontrol ettiğiniz altyapıda kalır. Hesapların nasıl doğrulanacağına, örneğinizin genel internetten erişilebilir olup olmayacağına ve arayüzün hangi markalamayı taşıyacağına siz karar verirsiniz.

Mod, başka nelerin çalışıyor olması gerektiğini belirler; bu nedenle kurulumdan önce buna karar verin.

simple varsayılan olarak gelen moddur ve yalnızca Valkey/Redis veri deposuna ihtiyaç duyar. full hesaplar için bir SQL veritabanı ekler; bu, varsayılan olarak sqlite://data/auth.db adresindeki SQLite’tır. PostgreSQL bir gereksinim değil, desteklenen bir seçenektir. Bir kapsayıcıda bu dosyanın yeniden başlatmadan sonra korunabilmesi için bağlanmış bir birime (volume) ihtiyacı vardır.

Simple veya Full sayfası, her modun neleri sağladığını, bu veritabanının nerede bulunması gerektiğini ve modu daha sonra değiştirmenin ne kadar zor olduğunu ele alır.

Aceleniz mi var ve zaten çalışan bir Valkey veya Redis’iniz mi var? Docker ile kurulum sayfasındaki tek docker run biçimi, 3000 numaralı bağlantı noktasında oluşturulmuş bir SECRET değeriyle bir örnek başlatır. Örnek ayağa kalktıktan sonra bu sayfadaki diğer her şey yine geçerlidir.

  • İmajlar ve varyantlar — yayımlanan imajlardan hangisinin çalıştırılacağı ve sürüm etiketlerinin nasıl çalıştığı.
  • Docker ile kurulum — projeyle birlikte gelen iki Compose yığını.
  • Linux üzerinde kurulum — Debian veya Ubuntu üzerinde doğrudan sunucuya kurulum. Projenin kurulum testleri başka hiçbir dağıtım ailesini kapsamaz.
  • Hizmet olarak çalıştırma — depoyla birlikte gelen systemd birimleri ve systemd olmayan sunucular için Procfile çalıştırıcısı.
  • Ters proxy ve TLS — uygulama TLS’i hiçbir zaman sonlandırmaz; bu nedenle önünde bir proxy olduğu varsayılır. Örneği dışa açmadan önce bunu okuyun.
  • Kurulumunuzu doğrulayın — örneği birine teslim etmeden önce gerçekten hizmet verdiğini kanıtlayın ve ilk hesabı oluşturun: site operatörü rolü yalnızca CLI üzerinden verilir.

Mevcut bir kurulumu mu yükseltiyorsunuz? Yükseltme Kılavuzları sayfası, kullanılabilir kılavuzları en yeniden başlayarak listeler. Şu anda çalıştırdığınız sürümden sonraki ilk kılavuzla başlayıp ileriye doğru ilerleyin ve aradaki her sürümün sürüm notlarını okuyun.

simple kimlik doğrulama modunda çalışan bir örnek için önerilen:

  • 2+ CPU çekirdeği
  • 2GB+ RAM
  • 10GB+ disk alanı

PostgreSQL’i, arka plan çalışanını ve zamanlayıcıyı da çalıştıran bir full modu dağıtımı bunun yaklaşık iki katına ihtiyaç duyar.

Bazı yönetim işlerinin uygulamada bir ekranı yoktur ve örneğinizin komut satırından yapılır.

Bir kuruluşu yeni bir sahibe aktarmak bunların başında gelir. Kuruluş sahiplerinin bunun için bir ekranı veya uç noktası yoktur; bu nedenle aktarımı sizin gerçekleştirmeniz gerekir. Aşağıdaki komutu kullanın. Otomasyon için Colonel API aynı işlemi POST /api/colonel/organizations/:org_id/transfer-ownership adresinde sunar; colonel rolünü gerektirir, onay olarak kuruluşun adını alır ve ön izleme olmadan hemen uygular.

Terminal penceresi
bin/ots org transfer-ownership ORG NEW_OWNER

ORG, kuruluşun herkese açık kimliği (extid, CLI’nin yazdırdığı kimlik) veya dahili kimliğidir (objid). NEW_OWNER bir e-posta adresi, bir müşteri extid’si veya bir Rodauth hesap kimliğidir ve zaten aktif bir üye olmalıdır — komut hiçbir zaman müşteri oluşturmaz; bu nedenle üye değillerse önce bin/ots memberships add ORG CUSTOMER komutunu çalıştırın.

--yes olmadan çalıştırıldığında, hiçbir şeye dokunmadan önce aktarımı planlar; kimin sahipliği kaybedeceğini, kaç sahip üyeliğinin hangi role indirileceğini yazdırır ve ardından onaylamanızı ister. n yanıtını vermek, bir aktarımı ön izlemenin yoludur. Seçenekler --demote-to ROLE (owner dışındaki herhangi bir üyelik rolü, varsayılan admin), --yes (ayrıca -y ve -f) ve --json şeklindedir.

Eski sahip kaldırılmaz, rolü düşürülür. İşlem, eski sahibin rolünü düşürmeden önce yeni sahibi yükseltir — tek sahip koruması diğer her sıralamayı reddeder — bu nedenle bu iki yazma işlemi süresince kuruluşun iki sahip üyeliği olur ve bin/ots org doctor, 4 numaralı kontrolü (membership_role_sync) uyarı olarak bildirir. Bir aktarım bu aralıkta kesilirse org doctor komutunu değil, aktarım komutunu yeniden çalıştırın. Aktarım idempotenttir ve diğer tüm sahiplerin rolünü düşürür; org doctor bu kontrolü repairable: false olarak işaretler ve düzeltmez.

Bunun son kullanıcı tarafı Sahiplik ve aktarım sayfasıdır; kullanıcılarınız size sormadan önce bunu okumuş olacaktır.

  • Kaynak kodu, sürüm notları ve projeyle birlikte gelen Compose yığınları için GitHub deposu.
  • Hatalar için, sürüm etiketi ve ilgili günlük satırlarıyla birlikte sorun izleyici.
  • Diğer her şey için doğrudan bize ulaşın.