Cara Mengubah DocumentRoot Apache di Ubuntu (Panduan Teknis)

Langkah Mengubah DocumentRoot Apache di Ubuntu

Untuk mengubah lokasi direktori utama (DocumentRoot) pada server Apache di Ubuntu, Anda harus memodifikasi file konfigurasi VirtualHost. Secara default, Apache menggunakan /var/www/html. Berikut adalah prosedur teknis untuk mengubahnya ke direktori baru, misalnya /var/www/proyek_baru.

1. Pindahkan Data Web

Pastikan direktori tujuan sudah ada dan memiliki izin akses yang benar agar Apache dapat membaca file di dalamnya.

sudo mkdir -p /var/www/proyek_baru
sudo chown -R $USER:$USER /var/www/proyek_baru
sudo chmod -R 755 /var/www/proyek_baru

2. Edit File Konfigurasi VirtualHost

Buka file konfigurasi default Apache menggunakan editor teks seperti nano atau vim.

sudo nano /etc/apache2/sites-available/000-default.conf

Cari baris DocumentRoot /var/www/html dan ubah menjadi direktori baru Anda:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/proyek_baru
    <Directory /var/www/proyek_baru>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

3. Terapkan Perubahan

Setelah menyimpan file, Anda wajib melakukan pengecekan sintaks dan memuat ulang layanan Apache agar perubahan diterapkan.

sudo apache2ctl configtest
sudo systemctl restart apache2
LangkahPerintah UtamaTujuan
Persiapanmkdir / chownMenyiapkan direktori dan hak akses
Konfigurasinano 000-default.confMengubah path DocumentRoot
Validasiapache2ctl configtestMemastikan tidak ada error sintaks
Eksekusisystemctl restart apache2Mengaktifkan konfigurasi baru

Troubleshooting Umum

  • Error 403 Forbidden: Pastikan user www-data memiliki hak akses baca pada direktori baru. Gunakan sudo chown -R www-data:www-data /var/www/proyek_baru.
  • Perubahan Tidak Muncul: Bersihkan cache browser atau pastikan file index.html atau index.php sudah tersedia di direktori baru.
  • File Konfigurasi Lain: Jika Anda menggunakan banyak domain, pastikan Anda mengedit file konfigurasi yang tepat di /etc/apache2/sites-available/, bukan hanya 000-default.conf.