Lewati ke konten
Kelarin Proyek
19 November 2026

Cara Deploy Laravel ke VPS dan cPanel

Langkah deploy Laravel ke VPS Ubuntu dengan Nginx dan PHP-FPM, serta ke hosting cPanel: struktur folder, .env, migrasi, SSL, dan pencadangan.

Aplikasi Laravel yang jalan di laptop belum otomatis jalan di server. Perbedaan versi PHP, izin folder, dan konfigurasi web server membuat banyak orang terjebak di halaman putih pada percobaan pertama. Artikel ini membahas dua jalur yang paling umum: VPS Ubuntu dengan Nginx dan PHP-FPM, serta hosting bersama berbasis cPanel. Pilih salah satu sesuai kebutuhanmu, atau baca keduanya untuk memahami bedanya.

VPS atau cPanel: mana yang cocok

Hosting cPanel cocok untuk aplikasi kecil dengan lalu lintas rendah: tugas kuliah, company profile, atau sistem internal sederhana. Pengaturannya lewat panel, dan perawatan server dilakukan penyedia. Kekurangannya, kendalimu terbatas: versi PHP terbatas pilihan, tidak bisa memasang layanan sendiri seperti queue worker permanen, dan kadang folder publik sulit diatur.

VPS memberi kendali penuh, tetapi kamu bertanggung jawab atas keamanan dan pembaruan. Pilih VPS bila aplikasi butuh queue, penjadwalan, versi PHP tertentu, atau akan tumbuh. Untuk belajar, VPS kecil sudah cukup, asalkan kamu mau menjaga server.

Bagian A: deploy ke VPS Ubuntu

Langkah 1: amankan server dasar

Login sebagai root sekali, lalu buat pengguna biasa dan matikan login root lewat kata sandi.

adduser deploy
usermod -aG sudo deploy
rsync --archive --chown=deploy:deploy ~/.ssh /home/deploy
ufw allow OpenSSH
ufw allow "Nginx Full"
ufw enable

Setelah itu, masuk sebagai deploy memakai kunci SSH dan nonaktifkan PermitRootLogin di /etc/ssh/sshd_config. Langkah kecil ini menutup pintu bagi sebagian besar percobaan masuk otomatis.

Langkah 2: pasang Nginx, PHP, dan MySQL

sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx mysql-server php8.3-fpm php8.3-mysql \
  php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip unzip git
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Sesuaikan nomor versi PHP dengan yang dibutuhkan aplikasimu. Pastikan ekstensi mbstring, xml, curl, dan pdo_mysql ada, karena Laravel bergantung padanya.

Langkah 3: buat database dan pengguna khusus

Jangan memakai akun root MySQL untuk aplikasi. Buat pengguna yang hanya punya hak pada satu database.

CREATE DATABASE aplikasi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'aplikasi_user'@'localhost' IDENTIFIED BY 'kata_sandi_kuat';
GRANT ALL PRIVILEGES ON aplikasi.* TO 'aplikasi_user'@'localhost';
FLUSH PRIVILEGES;

Langkah 4: unggah kode dan pasang dependensi

cd /var/www
sudo git clone https://github.com/akunmu/proyek.git aplikasi
sudo chown -R deploy:www-data aplikasi
cd aplikasi
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate

Edit .env untuk produksi: APP_ENV=production, APP_DEBUG=false, APP_URL sesuai domain, dan kredensial database yang baru dibuat. Lalu jalankan migrasi dan izin folder:

php artisan migrate --force
php artisan storage:link
sudo chmod -R 775 storage bootstrap/cache
php artisan config:cache && php artisan route:cache && php artisan view:cache

Langkah 5: konfigurasi Nginx

Buat berkas /etc/nginx/sites-available/aplikasi dengan isi berikut, dengan document root mengarah ke folder public.

server {
    listen 80;
    server_name contoh.com www.contoh.com;
    root /var/www/aplikasi/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Aktifkan dan uji konfigurasinya sebelum memuat ulang:

sudo ln -s /etc/nginx/sites-available/aplikasi /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Blok terakhir menolak akses ke berkas tersembunyi seperti .env. Itu lapisan pengaman tambahan, tetapi yang utama tetap document root ke public.

Langkah 6: pasang SSL gratis

Arahkan A record domain ke IP VPS, tunggu DNS menyebar, lalu jalankan Certbot.

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d contoh.com -d www.contoh.com

Certbot memasang sertifikat Let's Encrypt, mengalihkan HTTP ke HTTPS, dan menjadwalkan pembaruan otomatis. Cek dengan sudo certbot renew --dry-run agar tahu pembaruan akan berjalan.

Langkah 7: queue, jadwal, dan pencadangan

Bila aplikasi memakai antrean atau tugas terjadwal, tambahkan pengelola proses seperti Supervisor atau systemd untuk php artisan queue:work, serta satu baris cron untuk penjadwal Laravel:

* * * * * cd /var/www/aplikasi && php artisan schedule:run >> /dev/null 2>&1

Siapkan pencadangan database harian dan uji pemulihannya sekali. Cadangan yang belum pernah dicoba dipulihkan belum bisa disebut cadangan.

Bagian B: deploy ke hosting cPanel

Struktur folder yang aman

Prinsip utamanya sama: hanya isi folder public yang boleh diakses web. Di cPanel, cara paling aman adalah menaruh seluruh proyek di luar public_html, lalu mengarahkan domain ke folder public proyek lewat menu Domains, atau menyalin isi public ke public_html dan menyesuaikan jalur di index.php.

// public_html/index.php bila isi public dipindah ke public_html
require __DIR__.'/../aplikasi/vendor/autoload.php';
$app = require_once __DIR__.'/../aplikasi/bootstrap/app.php';

Jangan pernah menaruh seluruh proyek langsung di public_html, karena .env dan kode sumber bisa diunduh orang.

Versi PHP, database, dan unggah

Pilih versi PHP yang sesuai lewat menu Select PHP Version atau MultiPHP Manager dan aktifkan ekstensi yang dibutuhkan. Buat database dan pengguna lewat MySQL Databases, lalu isi .env dengan kredensialnya. Karena tidak semua hosting menyediakan SSH, kamu bisa mengimpor database lewat phpMyAdmin dari hasil ekspor lokal.

Bila tidak ada SSH untuk menjalankan Composer, jalankan composer install --no-dev di komputermu dengan versi PHP yang sama dengan server, lalu unggah folder vendor bersama kode. Cara ini kurang ideal, tetapi bekerja untuk hosting terbatas.

Cache dan izin

Pastikan folder storage dan bootstrap/cache bisa ditulis (izin 775). Tautan storage:link kadang tidak bisa dibuat di hosting bersama, sehingga gambar unggahan tidak tampil. Solusinya membuat symlink lewat skrip PHP satu kali atau memindahkan disk publik ke folder yang diakses langsung.

Daftar periksa sebelum menyatakan selesai

  1. Halaman depan dan beberapa rute dalam terbuka di HTTPS.
  2. Unggah gambar, kirim email, dan login berjalan.
  3. APP_DEBUG=false dan .env tidak bisa diunduh lewat peramban.
  4. Cadangan database ada dan sudah diuji dipulihkan.
  5. Kamu punya catatan langkah memperbarui aplikasi di kemudian hari.

Bila ingin dikerjakan orang lain

Deploy pertama sering memakan waktu karena banyak hal kecil yang harus cocok sekaligus. Bila kamu lebih suka menyerahkannya, layanan deploy Laravel ke VPS dan hosting mencakup server, SSL, dan dokumentasi langkahnya. Aplikasi yang belum jadi bisa dibantu lewat jasa Laravel, dan desain tabelnya lewat jasa database MySQL. Kalau sudah siap, ajukan pesanan dan kita tuliskan ruang lingkupnya dalam SOW sebelum ada pembayaran.

Punya proyek? Ngobrol dulu, gratis.