Knowledge Base MarchCell POS Tutorial

Installasi Linux (VPS Cloud)

K
Knowledge Base
17 Januari 2026
4 views
Tutorial
Artikel untuk: MarchCell POS
aplikasi kasir berbasis web yang dirancang untuk membantu operasional toko Anda. Aplikasi ini mencakup fitur penjualan produk (fisik), pencatatan layanan jasa (Transfer & STNK), manajemen stok, serta pelaporan keuangan otomatis.

Artikel ini ditujukan untuk tim IT yang ingin men-deploy aplikasi agar bisa diakses online.

# Panduan Deploy Aplikasi di Server Linux (VPS)

Berikut adalah langkah-langkah men-deploy aplikasi Marchcell POS ke VPS (Ubuntu) agar dapat diakses melalui domain internet.

## 1. Persiapan Lingkungan (Environment)
Masuk ke server via SSH, lalu jalankan perintah berikut baris demi baris untuk menginstall Node.js:

```bash
sudo apt update
curl -fsSL [https://deb.nodesource.com/setup_20.x](https://deb.nodesource.com/setup_20.x) | sudo -E bash -
sudo apt install -y nodejs build-essential

2. Upload & Instalasi

  1. Gunakan FileZilla atau SCP untuk mengupload source code aplikasi ke server (misal ke /var/www/marhcell).

    Catatan: Jangan upload folder node_modules.

  2. Kembali ke terminal SSH, masuk ke direktori folder:
    cd /var/www/marhcell

  3. Install dependensi:
    npm install

3. Menjalankan Aplikasi dengan PM2

Agar aplikasi tetap hidup selamanya (walaupun server restart), gunakan PM2.

  1. Install PM2:
    sudo npm install -g pm2
  2. Jalankan aplikasi:
    pm2 start app.js --name "marchcell-pos"
  3. Simpan konfigurasi startup:
    pm2 save
    pm2 startup

4. Konfigurasi Domain (Nginx)

Agar aplikasi bisa diakses tanpa port 3000 (menggunakan domain marchcell.appku.asia).

  1. Buat file config Nginx:
    sudo nano /etc/nginx/sites-available/marchcell
  2. Isi dengan konfigurasi berikut:
server {
    listen 80;
    server_name marchcell.appku.asia;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}
  1. Aktifkan dan restart Nginx:
    sudo ln -s /etc/nginx/sites-available/marchcell /etc/nginx/sites-enabled/
    sudo systemctl restart nginx

Terakhir diupdate: 17 Januari 2026