💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Cara Menjalankan File SHTML dengan Server Lokal & Hosting

File berformat .shtml (Server Side Includes HTML) tidak dapat dijalankan secara langsung hanya dengan mengklik dua kali file tersebut di browser seperti halnya file HTML biasa. File SHTML memerlukan web server yang mendukung modul Server Side Includes (SSI) agar perintah di dalamnya, seperti #include, dapat diproses dan dirender dengan benar ke browser klien.

Untuk menjalankan file SHTML dengan sukses, Anda memerlukan lingkungan server lokal (seperti Apache atau Nginx) atau akun web hosting yang sudah mengaktifkan modul SSI. Berikut adalah metode lengkap untuk menjalankan file SHTML di berbagai lingkungan.

Metode 1: Menjalankan File SHTML di XAMPP / Apache (Lokal)

Secara default, server Apache di XAMPP belum tentu mengaktifkan parsing SSI untuk file berformat .shtml. Anda harus mengonfigurasi file konfigurasi Apache terlebih dahulu.

  1. Buka direktori instalasi XAMPP Anda (biasanya di C:\xampp\apache\conf\).
  2. Buka file httpd.conf menggunakan teks editor seperti Notepad++ atau VS Code.
  3. Cari baris kode AddType text/html .shtml dan AddOutputFilter INCLUDES .shtml. Pastikan tanda pagar (#) di depannya dihapus (di-uncomment) agar aktif:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
  1. Cari blok konfigurasi direktori utama Anda (biasanya <Directory "C:/xampp/htdocs">) dan pastikan opsi Includes ditambahkan pada baris Options: 
    Options Indexes FollowSymLinks Includes
  2. Simpan file httpd.conf, lalu restart layanan Apache melalui XAMPP Control Panel.
  3. Letakkan file SHTML Anda di dalam folder htdocs (misalnya C:\xampp\htdocs\index.shtml).
  4. Buka browser dan akses melalui URL lokal: http://localhost/index.shtml.

Metode 2: Menjalankan File SHTML di Nginx (Lokal)

Jika Anda menggunakan Nginx sebagai web server lokal, modul SSI harus diaktifkan secara eksplisit di dalam blok server konfigurasi.

  1. Buka file konfigurasi Nginx Anda (biasanya nginx.conf).
  2. Tambahkan perintah ssi on; di dalam blok server atau location:
server {
    listen 80;
    server_name localhost;
    root /var/www/html;

    index index.shtml index.html;

    location / {
        ssi on;
        try_files $uri $uri/ =404;
    }
}
  1. Simpan file konfigurasi dan restart Nginx menggunakan terminal: sudo systemctl restart nginx.
  2. Akses file melalui http://localhost/namafile.shtml.

Metode 3: Menjalankan File SHTML di Web Hosting (cPanel)

Sebagian besar penyedia web hosting yang menggunakan cPanel sudah mendukung SSI secara otomatis. Anda hanya perlu memastikan struktur file benar.

  1. Login ke akun cPanel Anda dan buka File Manager.
  2. Unggah file SHTML Anda ke dalam direktori public_html.
  3. Jika perintah SSI (seperti menyertakan header atau footer) tidak berfungsi, buat atau edit file .htaccess di dalam folder public_html, lalu tambahkan baris kode berikut:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
  1. Simpan perubahan dan uji dengan mengakses domain Anda (misalnya https://namadomain.com/index.shtml).

Tabel Perbandingan Konfigurasi SSI per Server

Web Server File Konfigurasi Utama Parameter Kode SSI Tingkat Kesulitan Setup
Apache (XAMPP) httpd.conf Options Includes & AddOutputFilter Sedang
Nginx nginx.conf ssi on; Sedang
cPanel Hosting .htaccess / Default AddOutputFilter INCLUDES .shtml Mudah

Troubleshooting File SHTML Tidak Berfungsi

Jika file SHTML Anda hanya menampilkan teks kode SSI mentah (seperti <!--#include virtual="header.html" -->) atau menghasilkan error 500, periksa beberapa hal berikut:

  • Akses Langsung via File Lokal: Pastikan Anda tidak membuka file SHTML dengan cara mengklik dua kali dari Explorer (protokol file:///). Server web wajib aktif.
  • Sintaks SSI Salah: Periksa kembali penulisan tag SSI. Spasi di dalam tanda kurung siku sangat krusial, misalnya format yang benar adalah <!--#include virtual="file.html" -->.
  • Izin File (Permissions): Pada server berbasis Linux, pastikan izin file SHTML diatur ke 644 dan direktori ke 755.

🔍 Orang Lain Juga Mencari Ini