frappe_docker/dokploy/README.md

Frappe ERPNext - Dokploy için Hazır Kurulum

Bu klasör, Frappe ERPNext'i tüm popüler uygulamalarıyla birlikte Dokploy'da kolayca deploy etmek için hazırlanmıştır.

İçerilen Uygulamalar (Core + 3 Önemli App)

1. ERPNext - Tam özellikli ERP sistemi (Accounting, Inventory, Manufacturing, vb.)
2. HRMS - İnsan Kaynakları Yönetim Sistemi (Payroll, Leave, Attendance)
3. CRM - Müşteri İlişkileri Yönetimi (v1.53.1)
4. Helpdesk - Müşteri Destek ve Ticket Sistemi (v1.14.0)
5. Payments - Ödeme Gateway Entegrasyonları (Stripe, PayPal, Razorpay)

🎯 Neden Bu Uygulamalar?

Minimal ve Production-Ready Kurulum:

• ✅ Hızlı build (~15-20 dakika)
• ✅ Az disk kullanımı (~4-5 GB)
• ✅ Tüm core özellikler mevcut
• ✅ Frappe v15 tam uyumlu

İhtiyaç halinde eklenebilir: LMS, Builder, Print Designer, Wiki (manuel kurulum)

Not: Frontend port 8088 kullanılır. SSL/HTTPS Dokploy tarafından otomatik yönetilir.

Dokploy'da Kurulum

Yöntem 1: GitHub'dan Direkt Deploy (Önerilen)

1. Dokploy dashboard'unuza giriş yapın
2. "New Project" veya "New Service" butonuna tıklayın
3. "Docker Compose" seçeneğini seçin
4. Repository URL olarak GitHub fork'unuzu girin: https://github.com/ubden/frappe_docker
5. Branch: main
6. Docker Compose Path: dokploy/docker-compose.yml
7. Environment variables'ı ekleyin (.env.example dosyasına bakın)
8. Deploy butonuna tıklayın

💡 İpucu: Tüm environment variables listesi ve detaylı açıklamaları için:

• .env.example dosyasına bakın (örneklerle birlikte)
• ENV_VARIABLES.md dosyasında detaylı açıklamalar bulunur

Yöntem 2: Manuel Kurulum

1. Repository'yi klonlayın:

   git clone https://github.com/ubden/frappe_docker.git
   cd frappe_docker/dokploy
   

2. .env.example dosyasını .env olarak kopyalayın:

   cp .env.example .env
   

3. .env dosyasını düzenleyin:

   nano .env
   

   Aşağıdaki zorunlu değerleri güncelleyin:

   • SITE_NAME: Domain adınız (örn: erp.yourdomain.com)
   • ADMIN_PASSWORD: Güçlü bir şifre
   • DB_PASSWORD: Güçlü bir database şifresi

4. Docker Compose ile başlatın:

   docker-compose up -d
   

📚 Detaylı Bilgi: .env.example dosyasındaki tüm ayarların açıklamaları ve örnekleri için ENV_VARIABLES.md dosyasına bakın.

Environment Variables

Hızlı Başlangıç (Minimum Ayarlar)

Dokploy'da aşağıdaki zorunlu environment variables'ları ayarlayın:

SITE_NAME=erp.yourdomain.com
ADMIN_PASSWORD=YourSecure@Pass123!
DB_PASSWORD=YourDB@Pass456!

Tüm Ayarlar

.env.example dosyasında 50+ environment variable ve detaylı açıklamaları bulunur:

• ✅ Zorunlu Ayarlar: Site name, passwords
• 🌐 Network Ayarları: Ports, timeouts
• 🔧 Frappe Ayarları: Site resolution, real IP
• 📦 Docker Ayarları: Image, tags, pull policy
• 💾 Database Ayarları: MariaDB configuration
• 🔴 Redis Ayarları: Cache & Queue
• 🚀 Performance Ayarları: Timeouts, limits
• 🔐 Güvenlik Ayarları: SSL, secrets

📖 Detaylı Dokümantasyon:

• Tüm değişkenler: .env.example
• Açıklamalar ve örnekler: ENV_VARIABLES.md
• Konfigürasyon örnekleri: Development, Staging, Production

Örnek Konfigürasyonlar

Development

SITE_NAME=dev.localhost
HTTP_PORT=8080
PULL_POLICY=build
DEVELOPER_MODE=1

Production

SITE_NAME=erp.yourdomain.com
ADMIN_PASSWORD=Prod@SecurePass789!
DB_PASSWORD=Prod@DBSecure012!
PROXY_READ_TIMEOUT=300
CLIENT_MAX_BODY_SIZE=100m
PULL_POLICY=always
RESTART_POLICY=unless-stopped

Daha fazla örnek için .env.example dosyasına bakın.

İlk Kurulumdan Sonra

1. Site'a erişim için domain adınızı Dokploy'da yapılandırın

2. İlk giriş bilgileri:

   • Kullanıcı Adı: Administrator
   • Şifre: .env dosyasında belirlediğiniz ADMIN_PASSWORD

3. Tüm uygulamalar otomatik olarak kurulur ve kullanıma hazırdır

Önemli Notlar

Volumes (Veri Saklama)

Aşağıdaki volumes sistem tarafından oluşturulur ve verilerinizi saklar:

• mariadb-data: Veritabanı verileri
• redis-cache-data: Redis cache verileri
• redis-queue-data: Redis queue verileri
• sites: Frappe site dosyaları
• logs: Uygulama logları

Performans Ayarları

MariaDB için optimize edilmiş ayarlar:

• Max connections: 500
• InnoDB buffer pool: 2GB
• InnoDB log file: 512MB

Gerekirse docker-compose.yml dosyasındaki bu değerleri sunucu kapasitesine göre ayarlayabilirsiniz.

Backup

Site verilerinizi yedeklemek için:

# Container'a bağlanın
docker exec -it <backend-container-name> bash

# Backup oluşturun
bench --site <site-name> backup --with-files

# Backup dosyaları şu dizinde bulunur:
# /home/frappe/frappe-bench/sites/<site-name>/private/backups/

Güncelleme

Uygulamaları güncellemek için:

# Container'a bağlanın
docker exec -it <backend-container-name> bash

# Uygulamaları güncelleyin
bench --site <site-name> migrate

# Frontend assets'leri derleyin
bench build

Sorun Giderme

Site açılmıyor

• Browser cache'i temizleyin
• Backend container loglarını kontrol edin: docker logs <container-name>
• Database bağlantısını kontrol edin

Yavaş çalışıyor

• MariaDB buffer pool ayarlarını artırın
• Worker sayısını artırın (docker-compose.yml'de gunicorn workers)
• Redis memory limit'i kontrol edin

Kurulum başarısız

• Database şifresinin doğru olduğundan emin olun
• Container'ların healthy olup olmadığını kontrol edin: docker ps
• Configurator container loglarını inceleyin

Destek ve Dokümantasyon

• Frappe Docs
• ERPNext Docs
• Frappe Docker GitHub

Lisans

Bu proje Frappe ERPNext'in lisans koşullarına tabidir.