DirectAdmin File Manager Display Problem — Practical Troubleshooting Guide

[Aior]

Sorun Tanımı​

DirectAdmin kullanıcıları zaman zaman File Manager'ın boş veya bozuk görüntülenmesi sorunuyla karşılaşır. Sayfayı açtığınızda dosya listesi yerine yarım yüklenmiş arayüz, JavaScript hataları veya "Internal Server Error" gibi durumlar gelir. Bu sorun çoğunlukla DirectAdmin sürüm güncellemesinden sonra, PHP versiyon değişikliğinden sonra veya browser cache'inin bozulmasından kaynaklanır.

Bu rehber pratik çözüm sırasıyla problemi giderir.

İlk Kontrol — Browser Cache Temizleme​

En sık karşılaşılan neden tarayıcı önbelleğinde eski DirectAdmin asset'leridir. Önce şunları deneyin:

Hard refresh: Ctrl+Shift+R (Windows/Linux) veya Cmd+Shift+R (Mac)
Browser cache tamamen temizleme: Settings → Clear browsing data → Cached images and files

Farklı bir browser veya gizli pencerede (Incognito) tekrar deneyin. Hâlâ bozuk görünüyorsa sorun sunucu tarafındadır.

DirectAdmin Loglarını İnceleme​

SSH ile root olarak bağlanıp DirectAdmin loglarına bakın:

tail -100 /var/log/directadmin/error.log
tail -100 /var/log/httpd/error_log

PHP hataları, sertifika problemleri, file permission hataları gibi mesajlar olabilir. "Permission denied" hatası varsa kullanıcı dizini sahipliği bozulmuş demektir.

CustomBuild Güncelleme​

Çoğu File Manager bug'ı DirectAdmin sürüm güncellemesi ile giderilir:

cd /usr/local/directadmin/custombuild
./build update
./build update_versions
service directadmin restart

update_versions PHP, MySQL, web server gibi tüm bağımlı bileşenleri günceller. Restart sonrası File Manager'ı tekrar test edin.

File Manager Cache Temizleme​

DirectAdmin kendi tarafında bir önbellek tutar; bozulduğunda görsel hatalar oluşur:

rm -rf /usr/local/directadmin/data/users/*/cached/
service directadmin restart

Bu komut tüm kullanıcıların DirectAdmin önbelleğini temizler; servis yeniden başladığında yeniden oluşur.

PHP Sürümü Kontrolü​

File Manager belirli PHP modüllerine ihtiyaç duyar:

php -m | grep -iE "json|mbstring|fileinfo"

Üç modül de listede olmalıdır. Eksikse CustomBuild ile ekleyin:

cd /usr/local/directadmin/custombuild
./build set_php fileinfo yes
./build set_php mbstring yes
./build php_d

Sertifika Sorunu​

Bazen DirectAdmin'in kendi sertifikası bozulur:

cd /usr/local/directadmin/scripts
./letsencrypt.sh request_single server.aior.com 4096

veya:

./gencert.sh

Yeni sertifika oluşturulduktan sonra DirectAdmin servisini yeniden başlatın.

Disk Doluluğu​

Beklenmedik bir neden — disk dolu olduğunda DirectAdmin asset oluşturamaz:

df -h
du -sh /usr/local/directadmin/data/users/* | sort -h | tail -10

%100 doluluğa yakın kullanıcı dizini varsa onun temizlenmesi File Manager'ı çalıştırabilir.

Son Çare — DirectAdmin Reinstall​

Yukarıdakiler işe yaramazsa DirectAdmin binary'sini yeniden indirip eskinin üzerine yazabilirsiniz:

cd /usr/local/directadmin
./directadmin v3update

Bu işlem mevcut yapılandırmayı korur ama core binary'yi yeniler.

AIOR olarak DirectAdmin kullanan müşterilerimize bu tür sorunlarda 7/24 destek sağlıyoruz; özellikle CustomBuild update öncesinde otomatik yedek alıyor ve sorun yaşandığında rollback yapabiliyoruz.

Problem Description​

DirectAdmin users occasionally encounter a broken or blank File Manager. Instead of the file list you see a half-loaded UI, JavaScript errors or an "Internal Server Error". This usually happens after a DirectAdmin version upgrade, a PHP version change or a corrupted browser cache.

This guide walks through the diagnostic steps in pragmatic order.

First Check — Clear Browser Cache​

The most common cause is stale DirectAdmin assets in the browser cache. Try:

Hard refresh: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
Full cache clear: Settings → Clear browsing data → Cached images and files

Test in a different browser or Incognito window. If it still renders broken, the issue is server-side.

Examine DirectAdmin Logs​

SSH in as root and inspect:

tail -100 /var/log/directadmin/error.log
tail -100 /var/log/httpd/error_log

Look for PHP errors, certificate issues, file permission errors. "Permission denied" usually means user directory ownership is broken.

CustomBuild Update​

Most File Manager bugs are fixed by a DirectAdmin version upgrade:

cd /usr/local/directadmin/custombuild
./build update
./build update_versions
service directadmin restart

update_versions updates all dependent components (PHP, MySQL, web server). After restart, retest File Manager.

Clear File Manager Cache​

DirectAdmin keeps its own cache that can corrupt:

rm -rf /usr/local/directadmin/data/users/*/cached/
service directadmin restart

This clears the cache for every user; it rebuilds when the service comes back up.

Check PHP Version​

File Manager depends on specific PHP modules:

php -m | grep -iE "json|mbstring|fileinfo"

All three should appear. If missing, add via CustomBuild:

cd /usr/local/directadmin/custombuild
./build set_php fileinfo yes
./build set_php mbstring yes
./build php_d

Certificate Issue​

Sometimes DirectAdmin's own cert breaks:

cd /usr/local/directadmin/scripts
./letsencrypt.sh request_single server.aior.com 4096

or:

./gencert.sh

After generating a fresh certificate, restart DirectAdmin.

Disk Full​

An overlooked cause — when the disk is full, DirectAdmin can't write assets:

df -h
du -sh /usr/local/directadmin/data/users/* | sort -h | tail -10

If a user directory is near 100%, clearing it can restore File Manager.

Last Resort — DirectAdmin Reinstall​

If nothing else works, redownload the DirectAdmin binary over the existing install:

cd /usr/local/directadmin
./directadmin v3update

This preserves your config while refreshing the core binary.

AIOR provides 24/7 support for DirectAdmin customers with issues like these — we take automated backups before CustomBuild updates and can roll back if anything breaks.