Ortam Değişkenleri Referansı
ClearTX konteynerini başlatmadan önce tüm gerekli ortam değişkenlerini .env dosyanıza eklemeniz gerekir. Aşağıdaki tablolar, her bir değişkenin ne işe yaradığını ve örnek değerlerini açıklar.
Ortam Değişkenleri
Değişkenleri gruplara ayırarak yönetmek için aşağıdaki görsel özetten yararlanabilirsiniz.
Uygulama Genel Yapılandırması
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
ENV | development | Uygulamanın çalışma modu (production, staging, development). | Evet |
Bootstrap Ayarları
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
RUN_BOOTSTRAP_ON_STARTUP | true | İlk açılışta yönetici hesabı oluşturulmasını sağlar. | Evet |
BOOTSTRAP_ADMIN_PASSWORD | Admin123 | Oluşturulacak yönetici hesabının şifresi. Üretimde güçlü bir parola belirleyin. | Evet |
BOOTSTRAP_ADMIN_EMAIL | [email protected] | Oluşturulacak yönetici hesabının e-posta adresi. | Evet |
HTTP Sunucu Yapılandırması
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
PORT | 3000 | HTTP sunucusunun dinleyeceği port. | Evet |
ALLOWED_ORIGINS | 127.0.0.1:8080 | CORS için izin verilen origin listesi (virgülle ayrılmış). | Evet |
Veritabanı Yapılandırması
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
POSTGRES_HOST | localhost | PostgreSQL sunucusunun adresi. | Evet |
POSTGRES_PORT | 5432 | PostgreSQL port numarası. | Evet |
POSTGRES_USER | postgres | Veritabanı kullanıcı adı. | Evet |
POSTGRES_PASSWORD | postgres | Veritabanı kullanıcı parolası. | Evet |
POSTGRES_DB | ptravel | Kullanılacak veritabanı adı. | Evet |
POSTGRES_SSL_MODE | disable | Bağlantı için SSL modu (disable, require, verify-full, vb.). Üretimde TLS önerilir. | Evet |
Kimlik Doğrulama Yapılandırması
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
JWT_SECRET | your-jwt-secret-key-change-in-production | JWT imzalama anahtarı. Üretimde güçlü ve gizli bir değer seçin. | Evet |
JWT_ISSUER | ptravel-backend | JWT tokenlarında kullanılacak iss alanı. | Evet |
JWT_AUDIENCE | ptravel-api | JWT tokenlarında kullanılacak aud alanı. | Evet |
ACCESS_TOKEN_LIFETIME | 900 | Erişim tokenının geçerlilik süresi (saniye). | Evet |
REFRESH_TOKEN_LIFETIME | 2592000 | Yenileme tokenının geçerlilik süresi (saniye). | Evet |
MAX_FAILED_LOGIN_ATTEMPTS | 5 | Hesap kilitlenmeden önce izin verilen maksimum başarısız giriş denemesi. | Evet |
ACCOUNT_LOCK_DURATION | 900 | Hesap kilitlenme süresi (saniye). | Evet |
PASSWORD_RESET_TOKEN_LIFETIME | 3600 | Şifre sıfırlama tokenının geçerlilik süresi (saniye). | Evet |
EMAIL_VERIFICATION_LIFETIME | 86400 | E-posta doğrulama tokenının geçerlilik süresi (saniye). | Evet |
PASSWORD_MIN_LENGTH | 8 | Yeni şifreler için minimum uzunluk. | Evet |
BCRYPT_COST | 12 | BCrypt hashing cost faktörü. | Evet |
E-posta Yapılandırması (Opsiyonel)
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
SMTP_HOST | smtp.sendgrid.net | SMTP sunucusunun adresi. Boş bırakılırsa e-posta gönderimi devre dışı kalır. | Hayır |
SMTP_PORT | 587 | SMTP portu. STARTTLS için genellikle 587 kullanılır. | Hayır |
SMTP_USERNAME | apikey | SMTP kimlik bilgisi kullanıcı adı. | Hayır |
SMTP_PASSWORD | *** | SMTP kimlik bilgisi parolası veya tokenı. | Hayır |
EMAIL_FROM_ADDRESS | [email protected] | Gönderici e-posta adresi. SMTP devre dışı olsa bile doldurulması önerilir. | Hayır |
EMAIL_FROM_NAME | PTravel | Gönderici adı. | Hayır |
Loglama
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
LOG_LEVEL | debug | Uygulamanın log seviyesini belirler (debug, info, warn, error). | Evet |
Organizasyon Anahtarları
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
ORGANIZATION_PRIVATE_KEY | mysupersecretprivatekey | Organizasyona ait özel anahtar. Güvenle saklayın. | Evet |
ORGANIZATION_PUBLIC_KEY | mypublicnotsecretkey | Organizasyona ait herkese açık anahtar. Paylaşılabilir. | Evet |
TLS Yapılandırması
| Değişken | Örnek Değer | Açıklama | Zorunlu |
|---|---|---|---|
TLS_SERVER_KEY_PEM | -----BEGIN RSA PRIVATE KEY----- | Sunucu sertifikasının yolu. | Evet |
TLS_SERVER_CERT_PEM | -----BEGIN CERTIFICATE----- | Sunucu sertifikasının yolu. | Evet |
TLS_CA_ROOT_PEM | -----BEGIN CERTIFICATE----- | CA zincirisinin yolu. | Evet |