Sıfırdan sunucu kurulumundan zamanlanmış görevlere, Sanal POS, SMTP mail, Proxmox VDS, Plesk/cPanel, Mailcow ve Domain ayarlarından son kullanıcının kendi müşteri panelini nasıl kullanacağına kadar eksiksiz resimli başvuru rehberi.
Proxmox VE, VMware vSphere, Virtualizor, Hetzner, DigitalOcean, Vultr, Linode, Contabo ve Pterodactyl desteği. Müşteriniz panelinden noVNC Konsol açar, Format atar, Snapshot/Yedek alır, Root şifresini & SSH anahtarını sıfırlar.
Plesk, cPanel/WHM, DirectAdmin, CyberPanel, HestiaCP, Enhance ve Mailcow Kurumsal E-Posta entegrasyonu. DomainNameAPI, ResellerClub, Namecheap, NameSilo ile .com.tr dahil 700+ uzantıda anında tescil, NS ve DNS yönetimi.
PayTR, iyzico, Sipay, Garanti, İş Bankası/Akbank/Ziraat (Nestpay), Yapı Kredi (Posnet), VakıfBank, Stripe ve PayPal. TCMB otomatik döviz kurları, KDV hesabı, Paraşüt e-Fatura/e-Arşiv otomasyonu ve 5651 loglama.
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.
| Bileşen | Zorunlu / Önerilen Değer | Plesk / cPanel Üzerinde Nasıl Kontrol Edilir? |
|---|---|---|
| PHP Sürümü | PHP 8.2 veya 8.3 (Önerilen: 8.3 FPM + Apache) | Plesk → Alan Adları → PHP Ayarları |
| Veritabanı | MySQL 8.0+ veya MariaDB 10.6+ (utf8mb4) | Plesk → Veritabanları → Veritabanı Ekle |
| PHP Eklentileri | pdo_mysql, sodium (Ed25519 imza için), curl, mbstring, zip, gd, intl, openssl | Standart Plesk PHP 8.2/8.3 paketinde varsayılan açıktır |
| Web Sunucu & SSL | .htaccess (mod_rewrite) + Ücretsiz Let’s Encrypt SSL | Plesk → SSL/TLS Sertifikaları → Ücretsiz Kur |
| Yazma İzinleri | storage/ klasörü ve kök dizinde .env yazılabilir olmalı | Plesk Dosya Yöneticisi kendi sistem kullanıcısıyla otomatik yazabilir |
SSH bilginiz olmasa dahi yalnızca tarayıcı üzerinden 3 dakikada kurulumu tamamlayabilirsiniz:
biricp_panel), kullanıcı adını ve güçlü bir şifreyi not edin.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.https://alanadiniz.com adresine girdiğinizde sistem otomatik olarak Web Kurulum Sihirbazını başlatır.localhost · Port: 3306biricp_panel · Kullanıcı: biricp_usrTurboHost Bilişimyonetim-a8f3 (Güvenlik için özel yol!)BIRICP-XXXX-XXXX-XXXX-XXXXozgur_yonetim (admin kullanmayın)yonetim@alanadiniz.com/opt/plesk/php/8.3/sbin/php-fpm yazmayın! php-fpm bir web servisidir, komut satırı betiği çalıştırmaz ve 1 saniyede hatayla kapanır. Her zaman /bin/php (PHP CLI) veya Plesk’in "PHP betiği çalıştır" türünü kullanın.
httpdocs/bin/hccronPHP 8.3* * * * * (Her dakika)* * * * * /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
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.
Yönetim panelinize giriş yaptıktan sonra sol menüden Araçlar (Fiş ikonu) → Lisans & Abonelik sayfasına gidin:
https://biricp.comBIRICP-9F4A-7C21-E80B-31D9Lisansınız aktif olduktan sonra sol menüden Araçlar → Marketplace sayfasına tıklayın:
biricp/premier · v1.0.0 · Ed25519 İmzalıbiricp/proxmox · v1.2.0 · Ed25519 İmzalıbiricp/paytr · v1.2.0 · ÜcretsizAyarlar → 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.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.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.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.
premier)#2563eb · İkincil: #0f172aTRY (₺) · Ek: USD, EUR[↻ TCMB Kurlarını Şimdi Güncelle]%20 · Ön Ek: TH-2026-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:
Kendi Mail Sunucum / Mailcow / Plesk · Gmail · Yandex 360mail.alanadiniz.com587 (STARTTLS) veya 465 (SSL/TLS)bildirim@alanadiniz.com| Sağlayıcı | SMTP Sunucu | Port & Güvenlik | Önemli Not |
|---|---|---|---|
| Mailcow / Plesk Mail | mail.alanadiniz.com | 587 (STARTTLS) / 465 (SSL) | DNS’te SPF, DKIM ve DMARC kayıtlarınız tanımlı olmalıdır. |
| Google Workspace / Gmail | smtp.gmail.com | 587 (STARTTLS) | Normal hesap şifresi değil, Google Hesabı → Güvenlik → 16 haneli Uygulama Şifresi girilmelidir. |
| Yandex 360 Kurumsal | smtp.yandex.com | 465 (SSL) | Yandex posta ayarlarından "Üçüncü parti posta istemcisi / Uygulama şifresi" aktif edilmelidir. |
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.
Ödemenin onaylandığı saniye sunucunun otomatik kurulması için Sanal POS geri dönüş (Callback) adreslerini eksiksiz tanımlayın:
Merchant ID, Merchant Key, Merchant Salt girin.https://alanadiniz.com/callback/paytrTR... IBAN bilgilerinizi yazın.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).Ü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.TR-Plesk-01 · Host: plesk1.alanadiniz.com185.x.x.10 · ☑ SSL Kullan (Port 8443 / 2087)Plesk (veya cPanel)root · API Anahtarı / Secret Key: ••••••••••••ns1.alanadiniz.comns2.alanadiniz.comMüş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:
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.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.Ü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.Ü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.Proxmox-TR1 (pve) · Bridge: vmbr0192.168.35.150 · Bitiş: 192.168.35.200192.168.35.1 · CIDR: /24root şifresiyle PuTTY’den doğrudan bağlanı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.Ü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.Ü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.mail.alanadiniz.com · ☑ HTTPS (443)XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX10240 MB · Kutu Sayısı: 10 Adet · Webmail: SOGoAraçlar → Marketplace üzerinden DomainNameAPI (.tr / TRABİS dahil) veya ResellerClub / Namecheap / NameSilo modülünü kurun.Araçlar → Modüller → Alan Adı Yazmanları sekmesinden bayi kullanıcı adı ve şifrenizi/API anahtarınızı kaydedin.Ü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..com.tr → DomainNameAPI (Otomatik Tescil ☑).com → DomainNameAPI / ResellerClub.com.tr: Kayıt 149 ₺ · Yenileme 149 ₺ · Transfer 149 ₺.com: Kayıt 449 ₺ · Yenileme 499 ₺NVMe Bulut VDSEco Bulut VDS - 4G249 ₺ · 3 Aylık: 699 ₺ · Yıllık: 2.490 ₺0 ₺Proxmox (veya Plesk Plan Adı)2 Core · 4096 MB RAM · 60 GB Disk · Template 9000Ayarlar → Otomasyon & Yedek):
7 gün),
3 gün),
15 gün) belirleyin.
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.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.7 gün önce3 gün önce & 1, 3, 7 gün sonra3 gün gecikirse Otomatik Askıya Al15 gün gecikirse / iptal edilirse Sunucudan Sil[Oluştur / Kur] [Askıya Al] [Askıdan Aç] [Sil (Terminate)] [Şifre Değiştir]Faturalandırma → Ödenmemiş Faturalar içinden faturaya girip "Ödeme Ekle" dediğiniz an kurulum otomatik başlar!Müşteriler → Müşteri Detayı ekranındaki "Müşteri Olarak Giriş Yap" butonuyla müşterinin ekranını birebir görün.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:
root veya hosting şifresini görür, tek tıkla kopyalar.isim@alanadi.com posta kutusu açma, kota ve şifre güncelleme, Webmail açmaAraç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.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.v0.2.5 · Kanal: Resmi İmzalı Merkez[⬆ Güncellemeleri Denetle / Zip Yükle]storage/backups/[💾 Şimdi Tam Veritabanı Yedeği İndir]| Durum / Belirti | Nedeni | 1 Dakikada Çözümü |
|---|---|---|
| E-posta doğrulama linki 404 veriyor veya alt sayfalar açılmıyor | httpdocs/.htaccess dosyası yüklenmemiş veya Nginx ek kuralı eksik |
Zip içindeki gizli .htaccess dosyasını httpdocs/ dizinine atın. Saf Nginx kullanıyorsanız try_files $uri $uri/ /index.php?$query_string; ekleyin. |
| Plesk Cron "1 saniyede hatalarla tamamlandı" diyor | sbin/php-fpm çağrılmış |
Bölüm 3’teki gibi /opt/plesk/php/8.3/bin/php .../bin/hc cron veya "PHP betiği çalıştır" olarak değiştirin. |
| Doğrulama veya fatura e-postası gitmiyor | PHP mail() seçili veya Gönderen adresi SMTP hesabıyla farklı |
Ayarlar → E-posta sekmesinde SMTP seçin, Gönderen E-posta ile SMTP Kullanıcı e-postasını birebir aynı yapıp "Test E-postası Gönder" ile deneyin. |
| PuTTY ile VDS’ye girerken "Server refused our key / SSH key" soruyor | Proxmox Cloud-Init şablonunda ssh_pwauth kapalı |
Hizmet detayından Root Şifresi Sıfırla veya sipariş sırasında SSH Anahtarı ekleyin; şablonunuzda ssh_pwauth: 1 ayarını açık tutun. |
| Marketplace kurulumunda 402 Lisans / Tarife uyarısı çıkıyor | Pro paket Başlangıç/Deneme lisansı ile indirilmeye çalışılıyor | Araçlar → Lisans & Abonelik ekranından Profesyonel tarifeye yükseltin veya ilgili modülü tekil eklenti olarak tanımlayın. |