Setup VPS Ubuntu untuk PHP, Laravel, Nginx, dan MySQL

Panduan ini menjelaskan langkah setup VPS Ubuntu dari awal sampai aplikasi Laravel berjalan menggunakan:

• Nginx sebagai web server
• PHP-FPM untuk menjalankan PHP
• MySQL sebagai database
• Composer untuk dependency Laravel
• Node.js + npm untuk build asset frontend Laravel

Dokumen ini cocok untuk deployment manual pada server baru.

---

1. Asumsi lingkungan

Panduan ini menggunakan asumsi berikut:

• OS: Ubuntu 22.04 / 24.04
• User non-root dengan akses sudo
• Domain sudah diarahkan ke IP VPS (opsional, tapi disarankan)
• Project Laravel akan diletakkan di:

/var/www/namaproject

Contoh domain:

example.com

Ganti semua nama domain, path, dan nama database sesuai kebutuhan Anda.

---

2. Update server

Login ke VPS lalu jalankan:

sudo apt update && sudo apt upgrade -y

Install package dasar:

sudo apt install -y curl unzip git software-properties-common ca-certificates lsb-release apt-transport-https gnupg

---

3. Install Nginx

sudo apt install -y nginx

Jalankan dan aktifkan saat boot:

sudo systemctl enable nginx
sudo systemctl start nginx

Cek status:

sudo systemctl status nginx

Kalau firewall aktif, izinkan HTTP dan HTTPS:

sudo ufw allow 'Nginx Full'

---

4. Install MySQL

sudo apt install -y mysql-server

Aktifkan service:

sudo systemctl enable mysql
sudo systemctl start mysql

Jalankan secure installation:

sudo mysql_secure_installation

Ikuti langkah-langkah berikut:

• set password root jika diminta
• hapus anonymous users
• nonaktifkan remote root login
• hapus test database
• reload privilege tables

---

5. Buat database untuk Laravel

Masuk ke MySQL:

sudo mysql

Lalu buat database dan user:

CREATE DATABASE laravel_app CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'password_yang_kuat';
GRANT ALL PRIVILEGES ON laravel_app.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Catat data ini karena nanti dipakai di file .env Laravel.

---

6. Install PHP dan ekstensi yang dibutuhkan Laravel

Tambahkan repository PHP bila diperlukan:

sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

Install PHP 8.2 dan ekstensi umum Laravel:

sudo apt install -y php8.2 php8.2-fpm php8.2-cli php8.2-common php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-curl php8.2-zip php8.2-gd php8.2-intl php8.2-soap php8.2-readline

Cek versi PHP:

php -v

Cek service PHP-FPM:

sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm
sudo systemctl status php8.2-fpm

Jika server Anda memakai PHP 8.3, sesuaikan semua nama paket dan socket PHP-FPM.

---

7. Install Composer

Unduh installer Composer:

cd /tmp
curl -sS https://getcomposer.org/installer -o composer-setup.php

Install Composer global:

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Cek hasil install:

composer --version

---

8. Install Node.js dan npm

Laravel modern biasanya memerlukan Node.js untuk build asset.

Install Node.js dan npm dari repository Ubuntu:

sudo apt install -y nodejs npm

Cek versi:

node -v
npm -v

Jika Anda butuh versi Node.js yang lebih baru, bisa gunakan NodeSource atau nvm.

---

9. Siapkan folder project

Buat folder project:

sudo mkdir -p /var/www/namaproject
sudo chown -R $USER:$USER /var/www/namaproject

Masuk ke folder:

cd /var/www/namaproject

---

10. Upload atau clone project Laravel

Opsi A: Clone dari Git

git clone https://github.com/username/repository.git .

Opsi B: Upload manual

Upload source code Laravel ke folder:

/var/www/namaproject

Pastikan file seperti artisan, composer.json, dan folder public ada di root project.

---

11. Install dependency Laravel

Masuk ke folder project lalu jalankan:

cd /var/www/namaproject
composer install --no-interaction --prefer-dist --optimize-autoloader

Jika environment production, nanti setelah .env siap Anda bisa jalankan kembali dengan opsi tambahan:

composer install --no-dev --optimize-autoloader

---

12. Setup file environment .env

Copy file env:

cp .env.example .env

Edit file .env:

nano .env

Contoh konfigurasi penting:

APP_NAME=Laravel
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=http://example.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_app
DB_USERNAME=laravel_user
DB_PASSWORD=password_yang_kuat

Generate application key:

php artisan key:generate

---

13. Jalankan migrasi database

Jika project menggunakan migration:

php artisan migrate --force

Kalau ada seeder:

php artisan db:seed --force

---

14. Build asset frontend

Install dependency frontend:

npm install

Build production asset:

npm run build

Jika project lama masih memakai Laravel Mix:

npm run prod

---

15. Atur permission Laravel

Laravel butuh akses tulis ke folder storage dan bootstrap/cache.

Jalankan:

sudo chown -R www-data:www-data /var/www/namaproject
sudo find /var/www/namaproject -type f -exec chmod 644 {} \;
sudo find /var/www/namaproject -type d -exec chmod 755 {} \;
sudo chmod -R 775 /var/www/namaproject/storage
sudo chmod -R 775 /var/www/namaproject/bootstrap/cache

Jika Anda ingin user deploy tetap bisa edit file project, gunakan group yang sesuai. Namun untuk setup awal, konfigurasi di atas biasanya sudah cukup.

---

16. Konfigurasi Nginx untuk Laravel

Buat file server block baru:

sudo nano /etc/nginx/sites-available/namaproject

Isi dengan konfigurasi berikut:

server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/namaproject/public;

    index index.php index.html index.htm;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    charset utf-8;

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

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

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

Aktifkan site:

sudo ln -s /etc/nginx/sites-available/namaproject /etc/nginx/sites-enabled/

Hapus default site jika tidak dipakai:

sudo rm -f /etc/nginx/sites-enabled/default

Test konfigurasi:

sudo nginx -t

Reload Nginx:

sudo systemctl reload nginx

---

17. Optimasi Laravel untuk production

Masuk ke folder project:

cd /var/www/namaproject

Jalankan cache command berikut:

php artisan config:cache
php artisan route:cache
php artisan view:cache

Jika aplikasi memakai queue atau schedule, tambahkan konfigurasi berikut.

---

18. Setup queue worker (opsional)

Jika Laravel menggunakan queue, install Supervisor:

sudo apt install -y supervisor

Buat config:

sudo nano /etc/supervisor/conf.d/laravel-worker.conf

Isi:

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/namaproject/artisan queue:work --sleep=3 --tries=3 --timeout=90
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/namaproject/storage/logs/worker.log
stopwaitsecs=3600

Reload Supervisor:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start laravel-worker:*

---

19. Setup scheduler Laravel (opsional)

Edit crontab:

crontab -e

Tambahkan:

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

---

20. Pasang SSL dengan Let's Encrypt (opsional tapi sangat disarankan)

Install Certbot:

sudo apt install -y certbot python3-certbot-nginx

Pasang SSL:

sudo certbot --nginx -d example.com -d www.example.com

Ikuti instruksi sampai selesai.

Cek auto-renew:

sudo systemctl status certbot.timer

Test renew:

sudo certbot renew --dry-run

---

21. Checklist jika aplikasi belum jalan

Jika setelah setup aplikasi belum tampil normal, cek hal berikut:

Cek status service

sudo systemctl status nginx
sudo systemctl status php8.2-fpm
sudo systemctl status mysql

Cek error log Nginx

sudo tail -f /var/log/nginx/error.log

Cek log Laravel

tail -f /var/www/namaproject/storage/logs/laravel.log

Cek permission

Pastikan folder berikut bisa ditulis:

• storage
• bootstrap/cache

Cek koneksi database

Uji dengan:

php artisan migrate:status

Cek file .env

Pastikan parameter berikut benar:

• APP_ENV
• APP_DEBUG
• APP_URL
• DB_DATABASE
• DB_USERNAME
• DB_PASSWORD

Clear cache bila perlu

php artisan optimize:clear

Lalu cache ulang:

php artisan config:cache
php artisan route:cache
php artisan view:cache

---

22. Struktur deployment yang direkomendasikan

Minimal struktur project:

/var/www/namaproject
├── app
├── bootstrap
├── config
├── database
├── public
├── resources
├── routes
├── storage
├── vendor
├── .env
├── artisan
└── composer.json

Root web server harus diarahkan ke folder:

/var/www/namaproject/public

Bukan ke root project.

---

23. Urutan cepat deployment

Kalau ingin versi singkat, urutannya adalah:

sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx mysql-server git unzip curl software-properties-common ca-certificates lsb-release apt-transport-https gnupg
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install -y php8.2 php8.2-fpm php8.2-cli php8.2-common php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-curl php8.2-zip php8.2-gd php8.2-intl
sudo apt install -y nodejs npm
cd /tmp
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
sudo mkdir -p /var/www/namaproject
sudo chown -R $USER:$USER /var/www/namaproject
cd /var/www/namaproject
git clone https://github.com/username/repository.git .
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
nano .env
php artisan migrate --force
npm install
npm run build
sudo chown -R www-data:www-data /var/www/namaproject
sudo chmod -R 775 storage bootstrap/cache

Setelah itu buat config Nginx, aktifkan site, lalu reload Nginx.

---

24. Penutup

Dengan langkah di atas, VPS sudah siap menjalankan aplikasi Laravel menggunakan Nginx, PHP-FPM, dan MySQL.

Kalau Anda ingin workflow yang lebih rapi untuk production, tahap berikutnya biasanya meliputi:

• deployment via Git hook / CI-CD
• environment staging dan production
• Redis untuk cache dan queue
• fail2ban dan hardening server
• backup database otomatis
• monitoring log dan uptime

---

25. Catatan tambahan untuk project yang sering dipakai

Jika Anda sering deploy project Laravel, akan lebih efisien bila Anda menyiapkan:

• 1 user khusus deploy
• 1 script deployment
• branch production yang stabil
• .env terpisah per server
• backup database sebelum migrate besar

---

26. Contoh command deploy ulang setelah update code

Jika code sudah berubah dan ingin deploy ulang:

cd /var/www/namaproject
git pull origin main
composer install --no-dev --optimize-autoloader
npm install
npm run build
php artisan migrate --force
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
sudo systemctl reload php8.2-fpm
sudo systemctl reload nginx

---

27. Selesai

Jika semua langkah benar, aplikasi Laravel Anda seharusnya sudah dapat diakses melalui domain atau IP VPS.