Kurulum öncesi hazırlık: dosya yükleme, izinler ve Document Root
Bu adım, sıfır kurulum zip dosyasını sunucuya yüklediğinizi varsayar. Henüz indirmediyseniz: Admin → Sistem Güncelleme → Tam paket indir bölümünden alın.
1) Dosyaları sunucuya açma
- Plesk → Websites & Domains → siteadi.com → File Manager'ı açın.
- Site dizinine girin:
/var/www/vhosts/SITEADI/httpdocsveya/var/www/vhosts/SITEADI/SUBDOMAIN. - Eski Laravel dosyaları varsa tamamını silin (özellikle
public/index.html, eski.htaccess). - İndirdiğiniz
wg-panel-vX.Y.Z.zipdosyasını yükleyin ve aynı dizine açın.
SSH üzerinden alternatif:
cd /var/www/vhosts/SITEADI/SUBDOMAIN
unzip wg-panel-vX.Y.Z.zip
rm wg-panel-vX.Y.Z.zip
2) Document Root
WG Panel laravel projesidir; web sunucusu public/ dizinini sunmalıdır.
- Plesk: Websites & Domains → siteadi.com → Hosting & DNS → Hosting Settings
- Document root alanı:
SUBDOMAIN/public(örn.panel.example.com/public) - Apply'a basın.
Document Root yanlışsa kullanıcı sitenin köküne girdiğinde Plesk welcome sayfası gösterir veya 403 alır.
3) Dosya sahipliği ve izinler
Plesk kullanıcısının (örn. SITEADI_xxxxx) ve psacln grubunun tüm dosyalara erişebilmesi gerekir:
cd /var/www/vhosts/SITEADI/SUBDOMAIN
chown -R SITEADI_xxxxx:psacln .
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chmod -R 775 storage bootstrap/cache
Plesk kullanıcı adınızı bulmak için: ls -la /var/www/vhosts/SITEADI.
4) Storage symlink
Yüklenen logo / dosya / fatura görsellerinin görünebilmesi için sembolik bağ:
php artisan storage:link
Kurulum sihirbazı bunu otomatik yapmaya çalışır; manuel ihtiyaç sadece bağlantı silinirse oluşur.
5) Composer (sadece manuel kurulumda)
Sıfır kurulum zip'i vendor/ dizinini içerir. Sadece kendiniz kaynak kodu çekiyorsanız:
cd /var/www/vhosts/SITEADI/SUBDOMAIN
composer install --no-dev --prefer-dist --optimize-autoloader
6) .htaccess kontrolü
Plesk bazen SUBDOMAIN/.htaccess dosyası oluşturup içine Options FollowSymLinks yazıyor. Bu, AllowOverride ile çakışıp 500/403 hata verir. Varsa silin:
rm -f /var/www/vhosts/SITEADI/SUBDOMAIN/.htaccess
Ayrıca public/index.html dosyası varsa silin — Apache DirectoryIndex'te index.html, index.php'den önce gelir ve Laravel devreye giremez:
rm -f /var/www/vhosts/SITEADI/SUBDOMAIN/public/index.html
Bu adımlar tamamsa https://SUBDOMAIN/install.php sayfası açılmaya hazırdır.