Cara Install Node.js di Ubuntu 24.04

Aplikasi web modern seperti Next.js, Express, atau Nest.js membutuhkan runtime Node.js yang sesuai dengan versi yang didukung oleh framework tersebut. Memilih metode instalasi yang tepat menentukan seberapa mudah Anda mengelola versi Node.js di server produksi maupun lingkungan development.

Panduan ini mendemonstrasikan tiga metode instalasi Node.js di Ubuntu 24.04 menggunakan Nusa Cloud VPS sebagai lingkungan pengujian. Setiap metode memiliki keunggulan yang berbeda tergantung kebutuhan Anda.

Prasyarat Instalasi Node.js di Ubuntu 24.04

Pastikan Anda memenuhi kebutuhan berikut sebelum memulai instalasi:

• Server dengan sistem operasi Ubuntu 24.04 LTS.
• Pengguna yang memiliki hak akses sudo atau login sebagai root.
• Koneksi internet stabil untuk mengunduh paket dari repositori.

Lingkungan Pengujian

• Sistem Operasi: Ubuntu 24.04.4 LTS (Noble Numbat)
• Kernel: 6.8.0-124-generic
• Node.js (repositori default Ubuntu): v18.19.1
• Node.js (NodeSource): v22.23.0
• Node.js LTS (nvm): v24.18.0
• nvm: 0.40.3

Perbandingan Metode Instalasi Node.js

Sebelum memilih metode, pahami perbedaan mendasar antara ketiga opsi:

Aspek	Repositori Ubuntu	NodeSource	nvm
Versi tersedia	v18.19.1 (tetap)	v18, v20, v22 (pilih satu)	Semua versi
Update versi	Mengikuti siklus rilis Ubuntu	Mengikuti rilis NodeSource	Manual per user
Hak akses	sudo diperlukan	sudo diperlukan	Tanpa sudo
Multi-versi	Tidak	Tidak	Ya
Cocok untuk	Server sederhana	Server produksi	Development

Metode 1: Install Node.js dari Repositori Default Ubuntu

Metode paling sederhana yang menggunakan paket bawaan Ubuntu. Cocok untuk server yang membutuhkan versi stabil tanpa perlu update minor secara rutin.

Langkah Instalasi Node.js dari Repositori Ubuntu

1. Perbarui indeks paket repositori:

sudo apt update

2. Instal paket nodejs dan npm:

sudo apt install -y nodejs npm

3. Verifikasi hasil instalasi:

node --version
npm --version

Output yang diharapkan:

v18.19.1
9.2.0

Repositori default Ubuntu menyediakan Node.js v18 LTS yang menerima patch keamanan melalui mekanisme update Ubuntu. Versi ini tidak dapat dinaikkan ke v20 atau v22 melalui apt upgrade — untuk itu gunakan metode NodeSource atau nvm.

Metode 2: Install Node.js dari Repositori NodeSource

NodeSource menyediakan repositori APT resmi yang memungkinkan Anda memilih versi major Node.js tertentu (v18, v20, v22) dan menerima update minor serta patch secara otomatis melalui apt upgrade.

Mengimpor GPG Key dan Repositori NodeSource

1. Instal dependensi yang diperlukan untuk menambahkan repositori HTTPS:

sudo apt update
sudo apt install -y ca-certificates curl gnupg

2. Buat direktori keyring dan impor GPG key NodeSource:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

3. Tambahkan repositori NodeSource. Ganti nilai NODE_MAJOR sesuai versi yang Anda inginkan (18, 20, atau 22):

NODE_MAJOR=22
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

Instalasi Node.js dari NodeSource

4. Perbarui indeks paket dan instal Node.js:

sudo apt update
sudo apt install -y nodejs

Paket nodejs dari NodeSource sudah menyertakan npm secara otomatis — Anda tidak perlu menginstal paket npm terpisah.

5. Verifikasi hasil instalasi:

node --version
npm --version

Output yang diharapkan:

v22.23.0
10.9.8

Metode 3: Install Node.js Menggunakan nvm

Node Version Manager (nvm) memungkinkan instalasi beberapa versi Node.js secara paralel di dalam satu user account tanpa memerlukan sudo. Metode ini sangat berguna bagi developer yang mengerjakan beberapa proyek dengan kebutuhan versi Node.js yang berbeda.

Instalasi nvm di Ubuntu 24.04

1. Pastikan curl tersedia di sistem:

sudo apt update
sudo apt install -y curl

2. Unduh dan jalankan script instalasi nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Script ini mengunduh nvm ke direktori ~/.nvm dan menambahkan konfigurasi otomatis ke file ~/.bashrc.

3. Muat ulang konfigurasi shell agar perintah nvm tersedia:

source ~/.bashrc

4. Verifikasi instalasi nvm:

nvm --version

Output yang diharapkan:

0.40.3

Instalasi dan Pengelolaan Versi Node.js dengan nvm

5. Instal versi LTS terbaru:

nvm install --lts

6. Verifikasi versi yang terinstal:

node --version
npm --version

Output yang diharapkan:

v24.18.0
11.16.0

7. Untuk menginstal versi spesifik, tentukan nomor major version:

nvm install 22

8. Pindah antar versi yang sudah terinstal:

nvm use 22

9. Lihat semua versi Node.js yang terinstal:

nvm ls

10. Tetapkan versi default yang digunakan setiap kali membuka terminal baru:

nvm alias default 22

Konfigurasi npm Global Directory

Saat menggunakan metode repositori (Ubuntu default atau NodeSource), instalasi paket global npm memerlukan sudo secara default. Anda dapat mengubah direktori global npm agar tidak memerlukan sudo:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

Tambahkan path tersebut ke ~/.bashrc:

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Verifikasi konfigurasi:

npm config get prefix

Output yang diharapkan:

/home/<username>/.npm-global

Setelah konfigurasi ini, Anda dapat menginstal paket global tanpa sudo:

npm install -g pm2
pm2 --version

Pengujian Fungsional Node.js

Verifikasi bahwa Node.js berfungsi dengan benar dengan menjalankan script sederhana:

1. Buat file pengujian:

tee ~/test-node.js > /dev/null << 'EOF'
const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'application/json' });
  res.end(JSON.stringify({
    status: 'ok',
    node: process.version,
    platform: process.platform,
    arch: process.arch
  }));
});
server.listen(3000, () => {
  console.log('Server berjalan di http://localhost:3000');
});
EOF

2. Jalankan server pengujian:

node ~/test-node.js &

3. Kirim request ke server:

curl -s http://localhost:3000 | python3 -m json.tool

Output yang diharapkan:

{
    "status": "ok",
    "node": "v22.23.0",
    "platform": "linux",
    "arch": "x64"
}

4. Hentikan server pengujian:

kill %1
rm ~/test-node.js

Cara Menghapus Node.js dari Ubuntu 24.04

Menghapus Node.js dari Repositori Ubuntu atau NodeSource

⚠️ Peringatan: Perintah apt purge menghapus paket beserta file konfigurasinya secara permanen. Pastikan Anda telah melakukan backup proyek dan dependensi sebelum menjalankan perintah ini.

sudo apt purge -y nodejs npm
sudo apt autoremove -y

Jika menggunakan NodeSource, hapus juga file repositori:

sudo rm /etc/apt/sources.list.d/nodesource.list
sudo rm /etc/apt/keyrings/nodesource.gpg
sudo apt update

Menghapus nvm dan Node.js yang Dikelola nvm

nvm deactivate
rm -rf "$NVM_DIR"

Buka file ~/.bashrc menggunakan text editor pilihan Anda:

# Menggunakan nano:
nano ~/.bashrc

# Menggunakan vim:
vim ~/.bashrc

Hapus baris yang mengandung NVM_DIR, lalu muat ulang konfigurasi:

source ~/.bashrc

Troubleshooting Instalasi Node.js di Ubuntu 24.04

Error: bash: node: command not found Setelah Install via nvm

Penyebab: Konfigurasi nvm belum dimuat ke sesi shell yang aktif.

Solusi: Muat ulang konfigurasi shell:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Jika masalah berulang di setiap sesi baru, pastikan baris di atas ada di file ~/.bashrc.

Error: EACCES: permission denied Saat Install Paket Global npm

Penyebab: npm mencoba menulis ke direktori /usr/lib/node_modules/ yang memerlukan hak akses root.

Solusi: Konfigurasi direktori global npm di home directory (lihat bagian Konfigurasi npm Global Directory di atas), atau gunakan nvm yang secara default menginstal paket ke direktori user.

Error: E: Unable to locate package nodejs dari NodeSource

Penyebab: Repositori NodeSource belum ditambahkan dengan benar, atau GPG key tidak valid.

Solusi: Verifikasi file repositori dan GPG key:

cat /etc/apt/sources.list.d/nodesource.list
ls -la /etc/apt/keyrings/nodesource.gpg
sudo apt update

Jika file tidak ditemukan, ulangi langkah impor GPG key dan penambahan repositori dari bagian Mengimpor GPG Key dan Repositori NodeSource.

Konflik Antara Node.js Sistem dan nvm

Penyebab: Node.js terinstal melalui apt dan nvm secara bersamaan, menyebabkan konflik path $PATH.

Solusi: Hapus instalasi sistem terlebih dahulu sebelum menggunakan nvm:

sudo apt purge -y nodejs npm
hash -r
nvm use default
node --version

Verifikasi Akhir Instalasi Node.js

Jalankan checklist berikut untuk memastikan instalasi berhasil sepenuhnya:

echo "=== Node.js ===" && node --version
echo "=== npm ===" && npm --version
echo "=== Path ===" && which node
echo "=== Arsitektur ===" && node -p "process.arch"

Output yang diharapkan (contoh untuk metode NodeSource):

=== Node.js ===
v22.23.0
=== npm ===
10.9.8
=== Path ===
/usr/bin/node
=== Arsitektur ===
x64

Untuk metode nvm, path akan mengarah ke ~/.nvm/versions/node/v24.18.0/bin/node.