Kurulum rehberi — Northbytra

DokümantasyonSon güncelleme: 29.10.2026

Bu rehber tüm Northbytra web siteleri için geçerlidir: Bilişim & Teknik Servis Sitesi ve tüm sektör siteleri. Kurulum genellikle yaklaşık 30 dakika sürer. Bir FTP programına (ör. FileZilla) ve hostinginizin erişim bilgilerine ihtiyacınız var.

1. Doğru paketi seçin

Web sitesi: Bilişim & Teknik Servis Sitesi (bilgisayar tamiri, bilişim hizmetleri, güvenlik kamerası — online servis takibiyle) veya bir sektör sitesi: Mimarlık Ofisi, İnşaat Firması, Elektrik Taahhüt Firması, İç Mimarlık Stüdyosu, GES Kurulum Firması, Mobilya Mağazası & Üretici, Oto Tamir & Servis, Oto Lastik, Oto Çekici & Yol Yardım, Oto Boya & Kaporta, Araç Kiralama, Oto Galeri & Bayi ya da diğer tüm sektörler için Kendi İşin Web Sitesi. Siteleri ürünler sayfasında ve canlı demolarda karşılaştırabilirsiniz.
Sürüm: Standart — havale/EFT, kapıda ödeme veya mağazada ödeme ile siparişler. Pro — ek olarak PayTR veya Stripe ile online kart ödemesi. İki sürüm de aynı şekilde kurulur; daha sonra Standart'tan Pro'ya geçebilirsiniz, aktivasyon anahtarınız aynı kalır.
Bir paket = bir sektör: paketin tasarımı, menüsü, modülleri ve örnek içeriği kendi sektörü için hazırlanmıştır. Tüm metinler, görseller ve modüller yönetim panelinden değiştirilebilir; ancak bir paketin sektörü başka bir sektöre çevrilemez.
Ödemenin ardından sipariş sayfanızın bağlantısını içeren bir e-posta alırsınız: aktivasyon anahtarınızı orada görüntüler ve kişisel indirme bağlantınızı oradan kullanırsınız; cayma hakkı sona erdikten sonra anahtarın bir kopyası e-postayla da gönderilebilir. ZIP dosyasında upload klasörü ve dokümantasyon (KURULUM.md / INSTALL.md) bulunur.

2. Gereksinimler

PHP 8.1 veya üzeri; pdo_mysql, sodium, mbstring ve fileinfo eklentileri (gd ve intl önerilir) — çoğu hosting paketinde standarttır
MySQL 5.7+ veya MariaDB 10.3+
mod_rewrite etkin Apache veya LiteSpeed — ya da 10. bölümdeki kurallarla Nginx
Alan adınız için bir SSL sertifikası (çoğu hosting firmasında Let's Encrypt ile ücretsiz)

Kurulum sihirbazı, kurulum başlamadan önce tüm gereksinimleri kontrol eder.

3. Dosyaları FTP ile yükleyin

ZIP dosyasını bilgisayarınızda açın.
Hostinginize FTP ile — mümkünse SFTP veya FTPS ile — bağlanın ve upload klasörünün içeriğini, gizli .htaccess dosyaları dahil, alan adınızın kök dizinine (genellikle public_html, httpdocs veya htdocs) yükleyin.
Hosting panelinizde boş bir MySQL veritabanı ve bu veritabanında tüm yetkilere sahip bir kullanıcı oluşturun. Veritabanı adını, kullanıcı adını ve şifreyi not edin.

4. Kurulum sihirbazını çalıştırın

Alan adınızı tarayıcıda açın — sihirbaz otomatik olarak başlar. Dilini üst kısımdan değiştirebilirsiniz.
Veritabanı bilgilerini ve firma bilgilerinizi girin.
Web sitesinin ve yönetim panelinin varsayılan dilini, sunmak istediğiniz dilleri ve ülkenizi / bölgenizi seçin — saat dilimi, para birimi, telefon kodu ve kargo firmaları buna göre hazır gelir.
Yönetici hesabınızı oluşturun ve aktivasyon anahtarınızı girin (bkz. 5. bölüm).
Örnek içerik: eksiksiz bir siteyle başlamak için kutuyu işaretli bırakın — slider, hizmetler, projeler, ürünler, blog ve SSS on dilde hazır gelir. Sektör sitelerinde gerçek fotoğraflar (Pexels lisansı, ticari kullanım serbest), Bilişim sitesinde özgün çizimler bulunur. Her öğeyi daha sonra panelden koruyabilir, düzenleyebilir veya silebilirsiniz — boş bir siteyle başlamak için kutunun işaretini kaldırın.
Sihirbaz tamamlandığında sunucudaki install klasörünü silin ve app/config.php dosyasının bir yedeğini saklayın — kişisel verileri şifreleyen anahtar bu dosyadadır.

5. Lisansınızı etkinleştirin

Online etkinleştirme: kurulum sırasında sihirbaz anahtarınızı, alan adınızı ve yazılım sürümünü lisans sunucumuza gönderir. Anahtar bundan sonra sitenin kurulu olduğu alan adına bağlanır (www ile veya olmadan; başka bir alt alan adı için ayrı lisans gerekir).
Elle etkinleştirme kodu: sunucunuz internete çıkamıyorsa (ör. güvenlik duvarı giden bağlantıları engelliyorsa) sihirbaz "Elle etkinleştirme kodu" alanını gösterir. Sipariş numaranızı ve alan adınızı iletişim formu üzerinden bize gönderin; yalnızca bu anahtar ve bu alan adı için geçerli bir kod alırsınız.
Her lisans tek alan adı içindir: bir lisans yalnızca tek bir alan adında geçerlidir ve başka bir alan adına aktarılamaz. Başka bir web sitesi için yeni bir lisans gerekir.
Aktivasyon anahtarı sipariş sırasında belirttiğiniz alan adı için üretilir ve yalnızca orada çalışır (www ile veya olmadan). Site localhost veya başka yerel adreslere kurulamaz — doğrudan alan adınıza kurun.

6. Yönetim panelinde ilk adımlar

alanadiniz/admin adresinden giriş yapın ve kontrol panelindeki kurulum kontrol listesini adım adım tamamlayın:

Firma bilgileri (künye), logo, marka rengi ve tasarım teması
Teslimat seçenekleri ve havale için banka bilgileriniz
Yasal sayfa şablonları — kontrol edip işletmenize göre uyarlayın
Örnek metin ve fotoğrafları kendi içeriklerinizle değiştirin, ihtiyacınız olmayan modülleri kapatın

7. E-posta (SMTP) ve iki adımlı doğrulama

Site Ayarları → E-posta sayfasını açın; posta kutunuzun SMTP sunucusunu, portunu (STARTTLS ile 587 veya SSL ile 465), kullanıcı adını, şifresini ve gönderen adresini girin, ardından Kendime test gönder düğmesine tıklayın. Gmail ve Microsoft 365 için uygulama şifresi gerekir. Başarısız gönderimler, hatasıyla birlikte E-posta Bildirimleri altındaki gönderim kaydında listelenir.
Test e-postaları ulaştığında Profilim sayfasından iki adımlı doğrulamayı açın: her girişte şifrenizden sonra e-posta adresinize gönderilen 6 haneli kodu girersiniz. Yalnızca bir kez gösterilen on kurtarma kodunu güvenli bir yerde saklayın.

8. Yalnızca Pro: online kart ödemesi

Yönetim paneli → Online Ödeme sayfasını açın, PayTR veya Stripe'ı seçin ve sağlayıcı hesabınızdaki API bilgilerini girin (şifreli saklanır). Test modunu şimdilik açık bırakın.
PayTR: sayfada gösterilen bildirim adresini PayTR mağaza panelinde "Bildirim URL" alanına girin. Stripe: sayfada gösterilen webhook adresini ekleyin ve imza anahtarını (whsec_…) yapıştırın.
Teslimat Seçenekleri'nde müşterilerin kartla ödeyebileceği seçeneklerde "Kartla online ödeme" kutusunu işaretleyin.
Bir test siparişi verin; ardından test modunu kapatıp canlı anahtarlarınızı girin. Kart bilgileri yalnızca sağlayıcının güvenli sayfasında girilir ve sitenize hiçbir zaman ulaşmaz.

9. Yeni sürüme güncelleme

İçerikleriniz, ayarlarınız, çevirileriniz, siparişleriniz ve etkinleştirme anahtarınız veritabanında ve app/config.php dosyasında durur — güncelleme yalnızca program dosyalarını değiştirir. Lisansınız aynı kalır; yeniden etkinleştirme gerekmez.

Başlamadan önce

Yönetim panelinde Lisans ekranını açın: *Yazılım sürümü* satırı şu an kurulu sürümü gösterir. Yeni paketteki KURULUM.md / INSTALL.md dosyasında "Yenilikler" bölümünü okuyun.
Yeni paketi size özel indirme bağlantınızla indirin. Bağlantının süresi dolduysa sipariş numaranızı iletişim formu ile gönderin, size yeni bir bağlantı iletilir. Her zaman aynı web sitesini (aynı sektör) ve aynı sürümü (Standart veya Pro) kullanın — Standart'tan Pro'ya geçişte Pro paketini.
Yedek alın: veritabanını dışa aktarın (phpMyAdmin → Dışa aktar veya hostinginizin yedekleme özelliği) ve FTP ile app/config.php dosyasını ve uploads klasörünü bilgisayarınıza indirin. app/config.php kişisel verileri şifreleyen anahtarı içerir — bu dosya olmadan bu veriler bir daha okunamaz. Site klasörünün tamamının kopyası daha da iyidir.
Program dosyalarında kendiniz değişiklik yaptıysanız hangi dosyalar olduğunu not edin: yeni sürüm bu dosyaların üzerine yazar; değişikliklerinizi sonra yeniden uygulamanız gerekir.

Güncelleme

Yeni ZIP dosyasını bilgisayarınızda açın.
upload klasörünün içeriğini FTP ile önceki kurulumla aynı klasöre yükleyin ve FTP programının mevcut dosyaların üzerine yazmasına izin verin (gizli .htaccess dosyaları dahil). Önce sunucuda hiçbir şeyi silmeyin. Pakette app/config.php ve sizin görselleriniz yoktur; ayarlarınız ve uploads klasörü olduğu gibi kalır.
Sunucudaki install klasörünü yeniden silin.
Sitenizi açın ve yönetim paneline giriş yapın: veritabanı ilk ziyarette otomatik güncellenir (birkaç saniye sürer). Lisans ekranında artık yeni sürüm numarası görünür.

Sonra kontrol edin

Ana sayfayı ve her açık dilde birkaç sayfayı açın; iletişim formunu bir kez gönderin.
Pro: ödeme sağlayıcınızın test modunda bir test ödemesi yapın veya ödeme ayarlarını kontrol edin.
Görünüm eski veya bozuk mu? Sayfayı Ctrl + F5 ile yenileyin ve hostinginizin veya CDN'inizin önbelleğini temizleyin (ör. LiteSpeed Cache, Cloudflare).
Bir güncellemeyle gelen yeni diller kapalı eklenir — isterseniz yönetim panelinde Diller ekranından açın.

Bir sorun olursa

Beyaz sayfa veya 500 hatası: storage/logs içindeki en yeni dosyaya bakın — hata orada yazar.
Önceki sürüme dönmek için yedekten hem dosyaları hem veritabanını geri yükleyin. Eski program dosyalarını güncellenmiş veritabanıyla asla kullanmayın.

10. Nginx

Apache ve LiteSpeed, paketteki .htaccess dosyalarını kullanır. Nginx'te alan adınızın server bloğuna aşağıdaki kuralları ekleyin (PHP-FPM soketini sunucunuza göre düzenleyin):

location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ ^/(app|storage)(/|$) { deny all; }
location ~ ^/install/(?!index\.php$).+\.php$ { deny all; }
location ~ ^/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh)$ { deny all; }
location ~ /\. { deny all; }
location ~* \.(sql|md|log|lock|ini|bak|old|orig|sh|dist|env|json|yml|yaml|key|pem|zip|tar|gz)$ { deny all; }
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; }

11. Demo modu

Siteyi müşterilerinize veya ekibinize risksiz göstermek için app/config.php içinde 'demo' => true ayarını yapın. Ziyaretçiler bu durumda demo hesabıyla yönetim panelinin tamamını inceleyebilir; ancak hiçbir değişiklik kaydedilmez, iki adımlı doğrulama gizlenir ve içerik kendini otomatik olarak sıfırlar (aralık: demo_reset_minutes). Tüm demo ayarları paketteki dokümantasyonda açıklanmıştır.

12. Sorun giderme

Ana sayfa dışındaki tüm sayfalar 404 veriyor: .htaccess dosyası yüklenmemiş veya mod_rewrite kapalı.
Site başka bir adrese yönleniyor: app/config.php içindeki base_url değerini düzeltin.
E-postalar gelmiyor: SMTP ayarlarını kontrol edin ve gönderim kaydındaki hatayı okuyun.
Beyaz sayfa veya 500 hatası: storage/logs klasöründeki dosyalara bakın.

Kurulumda sorun mu yaşıyorsunuz? Kurulum konusunda yardım, ücretli kurulum hizmetimiz ile sunulur: fiyatlar sayfasından satın alın — ya da ödeme sırasında ekleyin — siteyi hostinginize sizin yerinize biz kuralım.