Genel Bakış
Bu kılavuz, Docker Compose kullanarak Twenty uygulamasını kurmak ve yapılandırmak için adım adım yönergeler sunar. Amaç, süreci sadeleştirmek ve kurulumunuzu bozabilecek yaygın sorunları önlemektir. Önemli: Yalnızca bu kılavuzda açıkça belirtilen ayarları değiştirin. Diğer yapılandırmaları değiştirmek sorunlara yol açabilir. İleri düzey yapılandırma için Ortam Değişkenlerini Ayarlama bölümüne bakın. Tüm ortam değişkenleri, değişkene bağlı olarak sunucu ve/veya işçi düzeyindedocker-compose.yml dosyasında tanımlanmalıdır.
Sistem Gereksinimleri
- RAM: Ortamınızda en az 2GB RAM bulunduğundan emin olun. Yetersiz bellek, işlemlerin çökmesine neden olabilir.
- Docker & Docker Compose: Her ikisinin de yüklendiğinden ve güncel olduğundan emin olun.
Seçenek 1: Tek satırlık komut dosyası
Tek bir komutla en son kararlı Twenty sürümünü yükleyin:- x.y.z’yi istediğiniz sürüm numarasıyla değiştirin.
- dal-adını yüklemek istediğiniz dal adıyla değiştirin.
Seçenek 2: Manuel adımlar
Manuel kurulum için bu adımları uygulayın.Adım 1: Çevre Dosyasını Kurun
-
.env Dosyasını Oluşturun
Örnek çevre dosyasını, çalışma dizininizde yeni bir .env dosyasına kopyalayın:
-
Bir Şifreleme Anahtarı Oluşturun
Benzersiz bir rastgele karakter dizisi oluşturmak için aşağıdaki komutu çalıştırın:
Önemli: Bu değeri gizli tutun / paylaşmayın.
ENCRYPTION_KEYkaybedilirse, veritabanında depolanan her gizli veriye (OAuth belirteçleri, uygulama değişkenleri, TOTP gizli anahtarları vb.) erişim de kaybedilir. -
.envGüncelleyin .env dosyanızdaki yer tutucu değeri oluşturulan jetonla değiştirin:Kesinti olmadan anahtarı döndürmeye ilişkin talimatlar için Anahtar döndürme kılavuzuna bakın. -
Postgres Şifresini Ayarlayın
.env dosyasındaki
PG_DATABASE_PASSWORDdeğerini özel karakter içermeyen güçlü bir şifre ile güncelleyin.
Adım 2: Docker Compose Dosyasını Edinin
docker-compose.yml dosyasını çalışma dizininize indirin:
Adım 3: Uygulamayı Başlatın
Docker konteynerlerini başlatın:Adım 4: Uygulamaya Erişin
Eğer twentyCRM’i kendi bilgisayarınızda barındırıyorsanız, tarayıcınızı açın ve http://localhost:3000 adresine gidin. Bir sunucuda barındırıyorsanız, sunucunun çalıştığını ve her şeyin yolunda olduğunu kontrol edinYapılandırma
Twenty’yi Dış Erişime Açma
Varsayılan olarak, Twentylocalhost üzerinde 3000 portunda çalışır. UI, API’ye tarayıcının kendi origin’inden erişir; bu nedenle konteynere ulaşan herhangi bir ana bilgisayar adından yüklenir — ancak yine de SERVER_URL değerini herkese açık URL’nize ayarlayın: sunucu bunu oluşturulan bağlantılar (e-postalar, OAuth geri çağrıları) ve güvenli çerezler için HTTPS’i saptamak amacıyla kullanır.
SERVER_URL’a Genel Bakış
- Protokol: Yapılandırmanıza bağlı olarak
httpveyahttpskullanın.- SSL ayarlamadıysanız
httpkullanın. - SSL yapılandırıldıysa
httpskullanın.
- SSL ayarlamadıysanız
- Alan Adı/IP: Uygulamanızın erişilebilir olduğu alan adı veya IP adresi.
- Port: Varsayılan portları kullanmıyorsanız, port numarasını ekleyin (
80httpiçin,443httpsiçin).
SSL Gereksinimleri
Belirli tarayıcı özelliklerinin düzgün çalışabilmesi için SSL (HTTPS) gereklidir. Bu özellikler yerel geliştirme sırasında çalışabilirken (tarayıcılar localhost’u farklı şekilde ele alır), Twenty’yi düzenli bir alanda barındırırken uygun bir SSL kurulumu gereklidir. Örneğin, panoya kopyalama API’si güvenli bir bağlam gerektirebilir - uygulama boyunca kopyalama düğmeleri gibi bazı özellikler HTTPS etkinleştirilmediğinde çalışmayabilir. Optimum güvenlik ve işlevsellik için Twenty’nin SSL sonlandırma ile bir ters proxy arkasında ayarlanmasını şiddetle öneririz.SERVER_URL’ı Yapılandırma
-
Erişim URL’nizi Belirleyin
-
Ters Proxy Olmadan (Doğrudan Erişim):
Uygulamaya doğrudan bir ters proxy olmadan erişiyorsanız:
-
Ters Proxy ile (Standart Portlar):
Nginx veya Traefik gibi bir ters proxy kullanıyorsanız ve SSL yapılandırıldıysa:
-
Ters Proxy ile (Özel Portlar):
Standart olmayan portlar kullanıyorsanız:
-
Ters Proxy Olmadan (Doğrudan Erişim):
Uygulamaya doğrudan bir ters proxy olmadan erişiyorsanız:
-
.envDosyasını Güncelleyin.envdosyanızı açın veSERVER_URL’i güncelleyin:Örnekler:- SSL olmadan doğrudan erişim:
- SSL ile alan adı aracılığıyla erişim:
- SSL olmadan doğrudan erişim:
-
Uygulamayı Yeniden Başlatın
Değişikliklerin etkili olması için Docker konteynerlerini yeniden başlatın:
Dikkat Edilmesi Gerekenler
-
Ters Proxy Yapılandırması:
Ters proxy’nin istekleri doğru iç bağlantı noktasına ilettiğinden emin olun (
3000varsayılan olarak). SSL sonlandırmasını ve gerekli tüm başlıkları yapılandırın. - Güvenlik Duvarı Ayarları: Dış erişime izin vermek için güvenlik duvarınızdaki gerekli portları açın.
-
Tutarlılık:
SERVER_URL, kullanıcıların uygulamanıza tarayıcıları ile nasıl eriştiği ile eşleşmelidir.
Süreklilik
- Veri Hacimleri: Docker Compose yapılandırması, veritabanı ve sunucu depolama için verileri kalıcı kılmak adına hacimler kullanmaktadır.
- Durumsuz Ortamlar: Eğer durumsuz bir ortama (örneğin, bazı bulut hizmetleri) dağıtım yapıyorsanız, verilerin kalıcılığını sağlamak için harici depolama yapılandırın.
Yedekleme ve Geri Yükleme
Düzenli yedeklemeler CRM verilerinizi kayıptan korur.Veritabanı Yedeği Oluşturun
Günlük Yedeklemeleri Otomatikleştirin
crontab’ınıza ekleyin (crontab -e):
Yedekten Geri Yükleyin
- Uygulamayı durdurun:
- Veritabanını geri yükleyin:
- Servisleri yeniden başlatın:
Yedekleme En İyi Uygulamaları
- Geri yüklemeleri düzenli olarak test edin — yedeklerin gerçekten çalıştığını doğrulayın
- Yedekleri farklı bir konumda saklayın — bulut depolama kullanın (S3, GCS, vb.)
- Hassas verileri şifreleyin — yedekleri şifreleme ile koruyun
- Birden fazla kopya saklayın — günlük, haftalık ve aylık yedekleri tutun