Görselli Kurulum, Ayarlar ve Son Kullanıcı Kullanım Rehberi

1. Sistem Gereksinimleri ve BiriCP Mimarisi

BiriCP, müşterilerinize gereksiz ağırlık yüklememek için Yalın Çekirdek (Slim Core) + İmzalı Marketplace mimarisiyle çalışır. İlk kurulum paketinde temel sistem, 2 çekirdek tema (biricp, klasik) ve 7 çekirdek modül (Banka Havalesi, Plesk, cPanel, Mailcow, Let’s Encrypt, Lisanslama, Webhook) yer alır. Diğer 15 vitrin temasını ve 57 otomasyon modülünü kurulum bittikten sonra panel içinden tek tıkla indirirsiniz.

2. Plesk / cPanel Üzerine İlk Kurulum Sihirbazı

SSH bilginiz olmasa dahi yalnızca tarayıcı üzerinden 3 dakikada kurulumu tamamlayabilirsiniz:

• 1
  Veritabanı Oluşturun: Plesk’te Veritabanları → Veritabanı Ekle butonuna basın. Veritabanı adını (ör. biricp_panel), kullanıcı adını ve güçlü bir şifreyi not edin.
• 2
  Paketi Yükleyin: BiriCP Müşteri Portalınızdan indirdiğiniz biricp-core-0.2.5-slim.zip dosyasını Plesk Dosyalar → httpdocs klasörüne yükleyip (varsa index.html dosyasını silerek) Arşivi Çıkar deyin. .htaccess gizli dosyasının httpdocs/.htaccess konumunda olduğundan emin olun.
• 3
  Tarayıcıdan Sihirbazı Açın: https://alanadiniz.com adresine girdiğinizde sistem otomatik olarak Web Kurulum Sihirbazını başlatır.

3. Zamanlanmış Görev (Cron Job) Kurulumu

Alternatif 1 — SSH / Komut Çalıştır Satırı (Plesk veya cPanel)

* * * * * /opt/plesk/php/8.3/bin/php /var/www/vhosts/alanadiniz.com/httpdocs/bin/hc cron >/dev/null 2>&1

cPanel sunucularda ise: * * * * * /usr/local/bin/php /home/KULLANICI/public_html/bin/hc cron >/dev/null 2>&1

Alternatif 2 — Dışarıdan HTTP Cron / Node.js Tetikleyici (Cron Çalışmayan Paylaşımlı Hostingler İçin)

Ayarlar → Otomasyon & Yedek sekmesinde yer alan Güvenli Cron Webhook URL adresini (https://alanadiniz.com/api/cron-webhook/GIZLI_TOKEN) ücretsiz bir dış izleme servisine (cron-job.org / UptimeRobot) veya Plesk’teki "Bir URL getir" görevine dakikada 1 çalışacak şekilde ekleyebilirsiniz. Ayrıca BiriCP’de sipariş anında tetiklenen Akıllı Arka Plan Kuyruğu (AsyncCron) sayesinde cron 1 dakika gecikse bile VDS/hosting kurulumu anında başlar.

4. Lisans Aktivasyonu ve Resmi Marketplace’ten Tema & Modül Kurulumu

Yönetim panelinize giriş yaptıktan sonra sol menüden Araçlar (Fiş ikonu) → Lisans & Abonelik sayfasına gidin:

Marketplace’ten Vitrin Teması ve Modül İndirme

Lisansınız aktif olduktan sonra sol menüden Araçlar → Marketplace sayfasına tıklayın:

5. Genel Ayarlar, Döviz Kurları, KDV/Faturalama ve Vitrin Özelleştirme

• 1
  Genel Ayarlar (Ayarlar → Genel Ayarlar): Firma unvanı, destek e-postası, varsayılan dil (Türkçe / İngilizce), müşteri kaydında E-posta Doğrulaması Zorunlu ve TC Kimlik Doğrulama (NVI) tercihlerini belirleyin.
• 2
  Faturalama & KDV (Ayarlar → Faturalama): Vergi/KDV oranını (ör. 20), fatura numarası ön ekini (ör. TH-{YEAR}-), banka/vergi dairesi alt bilgisini ve fatura vade gününü kaydedin.
• 3
  Para Birimleri & Otomatik TCMB Kur (Ayarlar → Para Birimleri & Kurlar): Ana para biriminiz TRY iken USD ve EUR ekleyip "Kurları Şimdi Güncelle" butonuna basın. Günlük cron TCMB kurlarını her gece otomatik günceller; dolar bazlı domain/lisans maliyetleriniz TL vitrine anlık yansır.
• 4
  Vitrin Teması, Logo ve Menüler (Site Yönetimi):
  • Vitrin Teması: Marketplace’ten indirdiğiniz temayı (ör. Premier, Turkuaz, Veriwise) etkinleştirip ana ve vurgu renklerini seçin.
  • Logo & Favicon: Açık/koyu zemin logonuzu ve tarayıcı ikonunuzu yükleyin.
  • Menü Yönetimi, Ana Sayfa Slaytları, Sayfalar, Bilgi Bankası ve Durum Sayfası ekranlarından vitrin içeriklerinizi kod yazmadan düzenleyin.

6. Kurumsal E-Posta (SMTP / Gmail / Yandex / Mailcow) ve SMS Ayarları

Müşteri kayıt doğrulama linklerinin, şifre sıfırlama ve fatura/sunucu teslimat e-postalarının spama düşmeden ulaşması için PHP mail() yerine mutlaka SMTP kullanın:

SMS & OTP Kurulumu: Araçlar → Marketplace üzerinden Netgsm, Verimor veya İleti Merkezi modülünü kurun. Ardından Araçlar → Modüller → SMS sekmesinden abone numarası, şifre ve onaylı SMS başlığınızı (Originator) girip Ayarlar → SMS sekmesinden hangi durumlarda (yeni fatura, destek yanıtı, telefon OTP doğrulama) SMS gideceğini seçin.

7. Sanal POS (PayTR, iyzico, Sipay, Banka POS) ve Havale/EFT Kurulumu

Ödemenin onaylandığı saniye sunucunun otomatik kurulması için Sanal POS geri dönüş (Callback) adreslerini eksiksiz tanımlayın:

8. Plesk, cPanel/WHM, DirectAdmin ve CyberPanel Sunucusu Bağlama

• 1
  Plesk API Anahtarı Alma: Hosting satacağınız Plesk sunucusunda root/admin ile oturum açın veya SSH’ta plesk bin secret_key -c -description "BiriCP" komutuyla bir Secret Key üretin (ya da yönetici kullanıcı adı + şifresini kullanın).
• 2
  cPanel/WHM API Token Alma: WHM → Development → Manage API Tokens → Generate Token menüsünden token oluşturun.
• 3
  BiriCP’ye Ekleme: Ürünler → Sunucular → Yeni Sunucu Ekle sayfasına gidip modül olarak Plesk veya cPanel seçin, Hostname (ör. srv1.alanadiniz.com), IP adresi, Nameserver (ns1 / ns2) ve API anahtarını girip Kaydet & Bağlantıyı Test Et butonuna tıklayın.

9. Proxmox VE Sunucu Kurulumu, IP Havuzu, Cloud-Init ve SSH/Şifre Ayarları

Müşterinin VDS paketi satın aldığında el değmeden IP atanması, işletim sisteminin kurulması ve PuTTY ile hem şifre hem SSH anahtarıyla girilebilmesi için şu 4 adımı uygulayın:

• 1
  Proxmox API Token Oluşturma: Proxmox arayüzünde Datacenter → Permissions → API Tokens → Add ekranından User: root@pam, Token ID: biricp seçin ve "Privilege Separation" kutusunun işaretini kaldırın (veya / yoluna PVEAdmin rolü verin). Verilen Secret değerini kopyalayın.
• 2
  Cloud-Init Şablon Hazırlığı: Proxmox’ta Ubuntu 22.04 / 24.04, Debian 12 veya AlmaLinux 9 Cloud-Init şablonlarınızın (ör. VMID 9000, 9001) içinde qemu-guest-agent ve SSH şifre girişi (PasswordAuthentication yes — BiriCP snippet/cloud-init ile de açılabilir) hazır olmalıdır.
• 3
  BiriCP’de Sunucu Tanımlama (Ürünler → Sunucular): Marketplace’ten Proxmox VE modülünü kurduktan sonra sunucuyu ekleyin: Hostname/IP, Port 8006, Kullanıcı root@pam!biricp, Erişim Anahtarı alanına Secret değerini, Varsayılan Node alanına Proxmox node adınızı (ör. pve) yazıp test edin.
• 4
  IP Havuzu Ekleme (Ürünler → IP Havuzları): Sunucuyu seçip dağıtılacak boş IPv4 adreslerini (ör. 185.10.20.150 - 185.10.20.190), Ağ Geçidi (Gateway, ör. 185.10.20.1), CIDR/Netmask (ör. 24) ve DNS (1.1.1.1) bilgilerini kaydedin.

10. Mailcow Kurumsal E-Posta Sunucusu Bağlama ve Paket Satışı

• 1
  Mailcow API Anahtarı: Mailcow yönetim panelinizde (ör. https://mail.alanadiniz.com/admin) System → Configuration → Access → Edit administrator details → API bölümünden Read-Write API Key üretin ve BiriCP sunucunuzun IP adresini izinli IP listesine (API Allow From) ekleyin.
• 2
  Sunucu Ekleme: Ürünler → Sunucular → Yeni Sunucu Ekle ekranında modül olarak Mailcow seçin; Hostname mail.alanadiniz.com ve API anahtarını girip bağlantıyı doğrulayın.
• 3
  Paket Oluşturma: Ürünler → Yeni Ürün Ekle ekranında modül olarak Mailcow seçip Toplam Alan Adı Kotası (MB) (ör. 10240 = 10 GB), Maksimum Posta Kutusu Sayısı (ör. 10) ve Kutu Başı Maks. Kota değerlerini belirleyin. Müşteri satın aldığında alan adı Mailcow’da otomatik açılır, DKIM kaydı üretilir ve müşteri kendi panelinden posta kutusu açıp şifre değiştirebilir.

11. Alan Adı Yazmanı (DomainNameAPI / ResellerClub) ve Uzantı Fiyatları

• 1
  Yazman Modülü: Araçlar → Marketplace üzerinden DomainNameAPI (.tr / TRABİS dahil) veya ResellerClub / Namecheap / NameSilo modülünü kurun.
• 2
  API Bilgileri: Araçlar → Modüller → Alan Adı Yazmanları sekmesinden bayi kullanıcı adı ve şifrenizi/API anahtarınızı kaydedin.
• 3
  TLD Fiyatlandırma (Ürünler → Alan Adı Fiyatları): .com, .net, .com.tr, .org gibi satmak istediğiniz uzantıları ekleyip 1–10 yıllık Kayıt, Yenileme ve Transfer fiyatlarını, varsayılan yazman modülünü ve "Ödeme alındığında otomatik tescil et" seçeneğini işaretleyin.

12. Ürün Grupları, Paket Oluşturma, Yapılandırılabilir Seçenekler ve Kuponlar

13. Fatura/Askı Otomasyonu, Paraşüt Resmi e-Fatura ve Güvenlik (2FA & 5651)

• 1
  Otomasyon Kuralları (Ayarlar → Otomasyon & Yedek):
  • Yenileme faturasının bitişten kaç gün önce oluşacağını (ör. 7 gün),
  • Vadesi geçen hizmetin kaçıncı günde Otomatik Askıya Alınacağını (Suspend) (ör. 3 gün),
  • Uzun süre ödenmeyen veya müşteri tarafından iptal edilen hizmetin sunucudan ne zaman Otomatik Silineceğini (Terminate) (ör. 15 gün) belirleyin.
• 2
  Paraşüt e-Fatura / e-Arşiv: Marketplace’ten biricp/parasut modülünü kurup Firma ID, Client ID, Client Secret ve Paraşüt kullanıcı bilgilerinizi girin. Fatura ödendiğinde müşterinin vergi numarasına göre otomatik e-Fatura veya e-Arşiv kesilir; PDF bağlantısı müşteri panelinde görünür.
• 3
  Yönetici Güvenliği & 5651 Loglama: Sağ üstteki profilinizden Hesabım → İki Adımlı Doğrulama (2FA) özelliğini etkinleştirin. Araçlar → Log Saklama (5651) ve Giriş Kayıtları sayfalarından yasal zaman damgalı erişim kayıtlarını denetleyebilirsiniz.

14. Sipariş Onaylama, Hizmet Komutları, Müşteri Yönetimi ve Destek Biletleri

15. Müşterileriniz BiriCP Müşteri Panelini Nasıl Kullanır?

Hizmet alan son kullanıcılarınız (müşterileriniz) https://alanadiniz.com/client adresinden giriş yaptıklarında tüm işlemlerini destek talebi açmadan kendileri yapabilirler:

16. Tek Tıkla Canlı Güncelleme (OTA), Yedekleme ve Sık Sorulan Sorular

• 1
  Canlıya Geçiş Kontrolü (Araçlar → Canlıya Geçiş Kontrolü): Satışa başlamadan önce bu sayfayı açın; SSL, Cron çalışması, SMTP ayarı, ödeme yöntemi ve güvenlik kontrollerinin tamamının yeşil Uygun olduğunu doğrulayın.
• 2
  Sistem Güncelleme & Yedekleme (Araçlar → Sistem Durumu & Yedekleme): Yeni bir BiriCP sürümü yayınlandığında "Güncellemeyi Şimdi Uygula" (veya elinizdeki güncelleme .zip paketini yükle) butonuna basın. Sistem önce veritabanı yedeği alır, Ed25519 imzasını doğrular ve kesintisiz günceller.

Sık Karşılaşılan Durumlar ve Hızlı Çözümleri