WHMCS Kurulum ve Temel Yapılandırma: Hosting Şirketi Başlatma Rehberi

WHMCS (Web Host Manager Complete Solution), hosting şirketleri için fatura, müşteri yönetimi, sunucu provisioning, destek talep yönetimi ve domain otomasyonu sunan endüstri standardı bir platformdur. Türkiye dahil dünyada büyük çoğunluk hosting firmasının arka ofis altyapısı WHMCS'tir.

Eğer Büyükweb reseller hosting ile kendi hosting şirketinizi kurmak istiyorsanız ya da WHMCS uyumlu hosting altyapısı arıyorsanız, bu rehber sıfırdan kurulumu adım adım anlatıyor.

Önce: WHMCS Lisansı

WHMCS ücretli bir yazılımdır; aylık veya yıllık lisans ile kullanılır. Pricing tier'ları:

Lisans	Müşteri Limiti	Yaklaşık Aylık Ücret (USD)
Starter	250	~17
Plus	500	~32
Professional	1.000	~46
Business	5.000	~76
Enterprise	Sınırsız	~119

Önemli: Büyükweb hosting paketlerinde WHMCS lisansı dahil DEĞİLDİR; WHMCS lisansını whmcs.com üzerinden veya yetkili reseller'dan kendiniz satın almalısınız.

Lisans satın alındıktan sonra:

• WHMCS hesabınıza login → My Services → WHMCS lisansınızı görün
• License Key kopyalayın

Ön Koşullar

Hosting Gereksinimleri

WHMCS PHP + MySQL tabanlıdır:

• PHP: 8.1+ (WHMCS 8.10+) — 8.3 önerilir
• MySQL/MariaDB: 5.7+ veya MariaDB 10.6+
• Disk: 1 GB minimum (büyük müşteri tabanı için 5+ GB)
• RAM: 2 GB minimum (Memory limit 512 MB önerilir)
• PHP Extensions:
  • curl, gd, json, mbstring, mysqli, openssl, pdo, zip, soap, bcmath, ioncube

Önerilen Hosting

Büyükweb cPanel hosting WHMCS için tüm gerekli PHP eklentilerine sahiptir; Performance veya Uçak paketi yeterli kapasitedir. Daha yüksek müşteri yükü için VDS önerilir.

IonCube Loader

WHMCS şifrelenmiş PHP koduyla geldiği için IonCube Loader zorunludur. cPanel hosting'lerde varsayılan kuruludur; VDS'te:

# Ubuntu / Debian
sudo apt install php8.3-ioncube-loader

# CentOS / Rocky
sudo dnf install ioncube-loader-php83

Adım 1: WHMCS'i İndirin

1. WHMCS hesabınıza login → My Services → Download
2. En son stabil sürümü seçin (örn. v8.x)
3. whmcs_latest.zip indirin

Adım 2: Subdomain veya Subdirectory Hazırla

WHMCS yaygın yerleştirme:

• Subdomain: my.example.com (önerilen — temiz URL)
• Subdirectory: example.com/whmcs veya example.com/billing

cPanel'de:

1. Domains → Subdomains → Create: my + example.com
2. Document root: /home/user/public_html/my

Adım 3: WHMCS'i Yükleyin

# cd subdomain root
cd /home/user/public_html/my

# Yüklenen ZIP'i çıkar
unzip /home/user/whmcs_latest.zip

# whmcs/ klasörünün içindekileri root'a taşı
mv whmcs/* .
mv whmcs/.htaccess .
rm -rf whmcs

# İzinleri ayarla
chmod 644 configuration.php  # İlk kurulumdan önce yazılabilir
chmod -R 755 attachments/ downloads/ templates_c/

Adım 4: Veritabanı Hazırlayın

cPanel → MySQL Databases:

1. Create New Database: user_whmcs
2. MySQL User: user_whmcsadmin
3. Strong password belirleyin
4. Kullanıcıyı veritabanına ekleyin → ALL PRIVILEGES

Adım 5: WHMCS Kurulum Wizard

https://my.example.com/install/install.php adresine girin.

Sayfa 1: License Agreement

EULA'yı kabul edin → Continue

Sayfa 2: System Compatibility

PHP version, eklentiler, IonCube doğrulama. Kırmızı işaret varsa hosting tarafında düzeltin.

Sayfa 3: Database Connection

• Database Hostname: localhost
• Database Username: user_whmcsadmin
• Database Password: az önce belirledikleriniz
• Database Name: user_whmcs
• Database Port: 3306 (default)

Sayfa 4: License & Admin Account

• License Key: WHMCS hesabınızdan kopyaladığınız anahtar
• Administrator Username: admin (önerilmez — youradmin gibi spesifik isim)
• Email: yöneticinin maili
• Password: güçlü parola

Sayfa 5: Installation Done

/install/ klasörünü silmeniz hatırlatılır. Mutlaka silin:

rm -rf /home/user/public_html/my/install

configuration.php izinleri:

chmod 400 configuration.php

Adım 6: Configuration.php Önemli Parametreler

<?php
$license = 'WHMCS-XXXXX-XXXXXX';
$db_host = 'localhost';
$db_username = 'user_whmcsadmin';
$db_password = 'STRONG_PASSWORD';
$db_name = 'user_whmcs';
$cc_encryption_hash = 'RANDOM_HASH_KURULUMDA_OTOMATIK_OLUSUR';

$customadminpath = 'panelyonetim'; // /admin yerine ÖZEL path — güvenlik
$mysql_charset = 'utf8mb4';
$display_errors = false; // production

customadminpath ile admin URL'sini gizlemek brute-force taramaları azaltır.

Adım 7: Cron Job Kurun

WHMCS otomatik fatura, hatırlatma, suspension için cron çalıştırır.

cPanel Cron

Cron Jobs:

*/5 * * * * php -q /home/user/public_html/my/crons/cron.php

Linux

crontab -e

# Ekle:
*/5 * * * * /usr/bin/php -q /home/user/public_html/my/crons/cron.php >/dev/null 2>&1

5 dk'da bir tetikleme önerilir; bu süre içinde:

• Fatura oluşturma
• Domain hatırlatma e-mailleri
• Otomatik domain renew
• Suspension/unsuspension
• Backup tetikleme

Adım 8: Genel Ayarlar

Setup → General Settings:

General Tab

• Company Name: Şirketiniz
• Email: ana destek e-postası
• Country: Turkey
• Currency: TRY
• Language: Turkish (önce dil paketi yüklenmeli)

Localisation Tab

• Default Language: turkish
• Date Format: DD/MM/YYYY
• Currency Symbol: ₺

Mail Tab

• Mail Delivery Method:
  • PHP Mail (basit ama spam filtresine takılabilir)
  • SMTP (önerilen — Gmail, SendGrid, Amazon SES, kendi SMTP)
• SMTP detayları (port 587, encryption TLS)

Security Tab

• Strong Password Policy: ✓
• Two-Factor Authentication: ✓ Enable
• CSRF Protection: ✓ Enabled

Domains Tab

• Registrar entegrasyonu (uluslararası ICANN akredite kayıt sağlayıcıları)

Adım 9: Ödeme Yöntemleri (Türkiye)

Setup → Payments → Payment Gateways:

iyzico (Türkiye)

• Hosted iyzico Payment Form modülü ücretli (3rd party)
• Alternatif: WHMCS API ile kendi entegrasyonunuzu yazın

PayTR

• WHMCS PayTR modülü mevcut (resmi)
• API key ve merchant ID gerekli

Banka Havale (Manual)

• Bank Transfer modülü built-in
• IBAN bilgileri faturada görünür

PayPal

• Yurt dışı müşteriler için ek seçenek
• WHMCS'te yerleşik

Adım 10: Sunucu Modülleri

Setup → Products/Services → Servers:

Türkiye'de Yaygın Modüller

• cPanel/WHM — paylaşımlı hosting otomasyon
• DirectAdmin — alternatif panel
• Plesk — Linux + Windows hosting
• CentOS Web Panel (CWP)
• VirtualMin — VPS otomasyon

cPanel Sunucu Ekleme

Setup → Products → Servers → Add Server:
  Name: cpanel-server-01
  Hostname: server.example.com
  IP: 193.x.x.x
  Module: cPanel
  Username: root
  Access Hash: (WHM'den oluştur — 256+ karakter)
  Type: cPanel

WHM tarafında:

WHM → Remote Access Key → Create Hash

Bu hash'i WHMCS Server config'e yapıştırın.

Adım 11: Hosting Paketleri Tanımla

Setup → Products/Services → Products:

Yeni Paket

• Product Type: Shared Hosting
• Module: cPanel
• Server Group: cpanel-server-01
• Plan Name: Başlangıç (cPanel'de tanımlı)
• Pricing:
  • Monthly: ₺50
  • Annually: ₺350 (15% indirim)
• Stock Control: ✗ (sınırsız)
• Welcome Email: Şablondan seç (Hosting Welcome Email)

Adım 12: E-posta Şablonları (Türkçe)

Setup → Email Templates:

Hazır şablonlar İngilizce; Türkçeleştirme zorunlu:

• Order Created
• Order Welcome
• Invoice Created
• Invoice Payment Confirmation
• Invoice Overdue
• Domain Renewal Notice
• Suspension Notification

Her şablonu tek tek Türkçe çevirin. WHMCS dil paketi (Turkish.php) bazı yerleri otomatik çevirir ama e-posta içerikleri manuel.

Adım 13: Müşteri Portal Tasarımı (Tema)

Setup → System Settings → Branding:

• Logo Upload: 200x60 PNG önerilir
• Favicon: 32x32 ICO
• Color Scheme: Markanıza uygun

Custom Tema (Opsiyonel)

templates/ klasöründe twenty-one (default) dışında:

• WHMCS Marketplace'ten tema (€20-100)
• Kendi temanızı kodlayın (HTML/CSS + Smarty)

Adım 14: Müşteri İlk Test Siparişi

Tüm sistemin çalıştığını doğrulamak için:

1. WHMCS frontend → Order
2. Bir test paket seçin
3. Müşteri kayıt → ödeme (manual havale ile test)
4. Admin panel → Orders → "Accept" + "Provision"
5. cPanel hesabı otomatik oluşturulmalı (cPanel server tarafına SSH ile log kontrol)

Güvenlik Best Practice

configuration.php izin

chmod 400 configuration.php
chown user:user configuration.php

Admin URL Gizle

$customadminpath = 'panelyonetim2026';

IP Whitelist for Admin

# .htaccess /panelyonetim2026/
<RequireAny>
  Require ip 1.2.3.4
  Require ip 5.6.7.8
</RequireAny>

CSF / mod_security

• WHMCS klasöründe /admin URL pattern'leri için CSF rate limit
• mod_security WAF rules

2FA

• Admin'lerde 2FA aktif (Google Authenticator)
• Müşterilerde 2FA opsiyonel

Performans İpuçları

MySQL Index

-- WHMCS otomatik indeksli, ama büyük veri setlerinde
SHOW INDEX FROM tblclients;
EXPLAIN SELECT * FROM tblinvoices WHERE userid = 1234;

Cache (PHP OPcache)

; php.ini
opcache.enable=1
opcache.memory_consumption=256
opcache.max_accelerated_files=20000

Activity Log Retention

WHMCS Activity Log ve Email Sent Log büyür; aylık olarak temizleyin:

DELETE FROM tblactivitylog WHERE date < DATE_SUB(NOW(), INTERVAL 90 DAY);
DELETE FROM tblemails WHERE date < DATE_SUB(NOW(), INTERVAL 90 DAY);

Genel Sorunlar

Sorun	Çözüm
"License Server unreachable"	Firewall whmcs.com için açık mı?
"IonCube Loader missing"	PHP IonCube extension yükle
Müşteri SMS almıyor	Mail config + SPF/DKIM kayıt
Cron çalışmıyor	crontab -l kontrol; mail log kontrol
Sunucu provisioning hata	WHM hash doğru mu? /var/log/messages kontrol
Slow performance	Database indeksler + activity log temizle

Sıkça Sorulan Sorular

WHMCS lisansı Türk müşterilerden TL alınabilir mi?

WHMCS lisansı USD ile satılır. Müşterinizden TL alabilir, kuru takip edebilirsiniz. Para birimi WHMCS panel'de TL olarak ayarlanır.

Tek lisansla kaç hosting markası işletebilirim?

Tek lisans = tek WHMCS install = tek müşteri kümesi. Birden fazla marka için Multi-Brand özelliği (Plus+) gerekli ya da ayrı kurulum + lisans.

Ücretsiz alternatifi var mı?

Blesta ($) ve HostBill ($) yine ücretli. Açık kaynak: CRMS ve TastyIgniter. Profesyonel hosting şirketleri için WHMCS endüstri standardıdır.

Kendi sunucumda WHMCS'i mi kursam, paylaşımlı hosting'de mi?

Küçük ölçek (≤500 müşteri): paylaşımlı cPanel hosting yeterli (Büyükweb cPanel paketleri). Orta-büyük ölçek (500+): VDS önerilir.

Türkçe dil dosyası nereden?

WHMCS topluluk forumlarında "Turkish.php" dosyası mevcut; /lang/ klasörüne yükleyin. Dil tamamen tamamlanmamış olabilir, kendi çevirilerinizle tamamlayın.

Hangi reseller paket WHMCS için uygun?

Büyükweb Linux Reseller Hosting WHMCS için PHP 8.3, IonCube, MySQL 5.7 standartlarını sağlar. WHMCS kurulumu sonrası kendi reseller paketinizdeki alt cPanel hesaplarına müşterilerinizi yönlendirebilirsiniz.

İlgili Rehberler

• Linux Reseller Hosting
• WHMCS Uyumlu Hosting
• cPanel Web Hosting
• cPanel SSL Sertifikası Kurulumu
• Türkiye Hosting Firmaları 2026

İlgili Büyükweb Hizmetleri

Hosting otomasyonu ve müşteri yönetimi için Türkiye lokasyonlu Büyükweb hizmetleri:

• Linux Reseller Hosting
• WHMCS Uyumlu Hosting
• cPanel Web Hosting
• WHMCS için Türkiye VDS
• Dedicated Sunucu

Sorularınız için 0850 302 60 70 numaralı destek hattımıza veya iletişim sayfamıza yazabilirsiniz.