Cara Menginstal Node.js di Ubuntu: Panduan Lengkap dengan APT, NodeSource, dan nvm

目次

1. Pendahuluan: Mengapa Menggunakan Node.js di Ubuntu?

Kompatibilitas Luar Biasa Antara Ubuntu dan Node.js

Node.js adalah platform untuk menjalankan JavaScript di sisi server dan banyak digunakan untuk aplikasi web serta pengembangan alat. Ubuntu, di sisi lain, adalah distribusi Linux yang dipercaya oleh banyak pengembang dan administrator server. Dengan menggabungkan keduanya, Anda dapat membangun lingkungan pengembangan yang unggul dalam stabilitas, fleksibilitas, dan kecepatan.

Menginstal Node.js di Ubuntu memberikan keuntungan berikut:

  • Sistem operasi yang ringan dengan overhead minimal, memungkinkan penggunaan sumber daya sistem yang efisien
  • Lingkungan berbasis Linux yang terpadu dari pengembangan hingga pengujian dan produksi
  • Kompatibilitas tinggi dengan Node.js serta integrasi mulus dengan alat seperti npm dan nvm

Untuk alasan‑alasan ini, kombinasi Ubuntu dan Node.js sangat menarik sebagai lingkungan pengembangan untuk pekerjaan frontend maupun backend.

Target Pembaca dan Tujuan Artikel Ini

Artikel ini ditulis untuk pembaca berikut:

  • Mereka yang ingin menggunakan Node.js di Ubuntu untuk pertama kalinya
  • Mereka yang ingin mengetahui metode instalasi mana yang terbaik
  • Mereka yang ingin menggunakan versi Node.js terbaru tetapi belum yakin tentang konfigurasi

Dengan membaca artikel ini, Anda akan dapat membandingkan tiga metode instalasi Node.js yang berbeda di Ubuntu dan memilih pendekatan yang paling sesuai berdasarkan tujuan dan tingkat keahlian Anda. Selain itu, panduan ini mencakup alat terkait seperti npm dan yarn, serta solusi untuk kesalahan umum, membantu Anda menggunakan lingkungan Node.js dengan percaya diri.

2. Ikhtisar Metode Instalasi Node.js di Ubuntu

Tiga Metode Instalasi, Masing‑Masing dengan Karakteristiknya

Ada tiga cara utama untuk menginstal Node.js di Ubuntu:

  1. Menginstal paket standar melalui APT (Advanced Package Tool)
  2. Menginstal melalui NodeSource PPA (Personal Package Archive)
  3. Menggunakan nvm (Node Version Manager) untuk manajemen versi yang fleksibel

Setiap metode memiliki kelebihan dan kekurangannya, dan pilihan terbaik bergantung pada kasus penggunaan serta konfigurasi sistem Anda. Tabel berikut merangkum karakteristik masing‑masing.

Tabel Perbandingan Metode Instalasi Node.js

Installation MethodMain FeaturesAdvantagesDisadvantagesRecommended For
APT (Default)Uses Ubuntu’s official repositorySimple and safeVersion may be outdatedBeginners who want to try quickly
NodeSource PPAManages newer Node.js versions via APTRelatively up-to-date versionsRequires adding a PPADevelopers who want a stable recent version
nvmSupports switching between multiple versionsHighly flexible and ideal for developmentRequires shell configurationRecommended for learning and development

Mengapa Perbandingan Penting?

Ubuntu mengutamakan stabilitas, yang berarti versi perangkat lunak di repositori APT cenderung konservatif. Akibatnya, pengguna yang menginginkan fitur Node.js terbaru atau perlu menguji banyak versi sebaiknya mempertimbangkan opsi selain APT.

Di sisi lain, jika tujuan Anda hanya mencoba Node.js dengan cepat atau menghindari konfigurasi tambahan pada server produksi, metode APT mungkin sudah cukup.

Metode Mana yang Harus Anda Pilih?

Kesimpulannya, bagi pengembang atau siapa pun yang berencana menggunakan Node.js dalam jangka panjang, menginstal melalui nvm adalah pendekatan yang paling direkomendasikan.
Alasannya meliputi:

  • Mudah beralih antara versi terbaru dan versi lama
  • npm terinstal secara otomatis
  • Masalah izin lebih sedikit (tidak memerlukan sudo)

3. Metode ①: Menginstal Node.js dengan Mudah melalui APT (Resmi Ubuntu)

Apa Itu APT? Sistem Manajemen Paket Standar di Ubuntu

APT (Advanced Package Tool) adalah sistem manajemen paket standar yang digunakan oleh Ubuntu dan distribusi Linux berbasis Debian lainnya. Dengan APT, Anda dapat dengan mudah menginstal, memperbarui, dan menghapus perangkat lunak menggunakan satu perintah.

Repositori resmi Ubuntu mencakup paket Node.js, yang berarti Anda dapat menginstal Node.js secara langsung tanpa persiapan khusus.

Langkah‑Langkah Instalasi

  1. Perbarui daftar paket APT.
    sudo apt update
    
  1. Instal Node.js dan npm.
    sudo apt install nodejs npm
    
  1. Verifikasi instalasi.
    node -v
    npm -v
    

Jika informasi versi ditampilkan, instalasi berhasil.

Keuntungan: Sederhana dan Aman

  • Sangat dapat diandalkan karena menggunakan repositori resmi Ubuntu
  • Perintah sederhana yang mudah dipahami pemula
  • Terintegrasi dengan pembaruan sistem melalui APT

Kerugian: Versi Mungkin Ketinggalan Zaman

Karena APT memprioritaskan stabilitas, versi Node.js yang tersedia mungkin beberapa generasi tertinggal.

Misalnya, pada Ubuntu 22.04, versi Node.js yang diinstal melalui APT mungkin versi 12 atau 14, yang berarti fitur terbaru dan perbaikan keamanan mungkin tidak termasuk.

Metode ini juga tidak cocok jika Anda perlu menggunakan beberapa versi Node.js di berbagai proyek.

Siapa yang Cocok dengan Metode Ini

  • Pemula yang ingin mencoba Node.js segera
  • Lingkungan produksi di mana versi stabil sudah cukup
  • Pengguna yang tidak memerlukan beberapa versi Node.js

4. Metode ②: Menginstal Versi Terbaru dengan NodeSource PPA

Apa Itu NodeSource?

NodeSource adalah penyedia tepercaya yang menyediakan versi Node.js stabil dan terbaru dengan cepat, independen dari tim Node.js resmi. Ini sangat berguna untuk pengguna Ubuntu dan Debian yang ingin menginstal versi Node.js yang lebih baru sambil terus menggunakan APT.

Metode ini direkomendasikan di situs web resmi Node.js dan banyak digunakan di lingkungan perusahaan.

Langkah Instalasi (Contoh: Node.js 18.x)

  1. Perbarui daftar paket.
    sudo apt update
    
  1. Instal curl jika belum terinstal.
    sudo apt install curl
    
  1. Jalankan skrip pengaturan NodeSource.
    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    
  1. Instal Node.js.
    sudo apt install -y nodejs
    
  1. Verifikasi instalasi.
    node -v
    npm -v
    

Keuntungan: Gunakan Versi Terbaru dengan APT

  • Instalasi mudah untuk versi stabil Node.js terbaru
  • Manajemen berbasis APT yang familiar
  • npm diinstal secara otomatis

Kerugian: Memerlukan Penambahan PPA

  • Sedikit lebih banyak langkah dibandingkan instalasi APT standar
  • Memerlukan evaluasi kepercayaan sumber (NodeSource umumnya aman)

Siapa yang Cocok dengan Metode Ini

  • Pengembang yang menginginkan versi Node.js stabil dan terkini
  • Pengguna yang merasa repositori Ubuntu tidak mencukupi tetapi tidak ingin menggunakan nvm
  • Mereka yang ingin mempertahankan manajemen paket berbasis APT yang terpusat

5. Metode ③: Manajemen Versi Fleksibel dengan nvm (Direkomendasikan)

Apa Itu nvm? Alat Kuat untuk Mengelola Versi Node.js

nvm (Node Version Manager) adalah alat baris perintah yang memungkinkan Anda mengelola dan beralih antara beberapa versi Node.js. Ini sangat berguna untuk pengembang yang membutuhkan versi berbeda per proyek atau ingin menguji rilis terbaru dan LTS.

Dengan nvm, Anda dapat membangun lingkungan pengembangan fleksibel sepenuhnya dalam akun pengguna Anda, tanpa menginstal Node.js secara sistem-luas.

Menginstal nvm

  1. Jalankan skrip instalasi menggunakan curl.
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
    
  1. Muat ulang file konfigurasi shell Anda.
    source ~/.bashrc
    

Atau, jika Anda menggunakan Zsh:

source ~/.zshrc
  1. Verifikasi bahwa nvm terinstal.
    command -v nvm
    

Jika nvm ditampilkan, instalasi berhasil.

Menginstal Node.js dengan nvm

  1. Instal versi LTS:
    nvm install --lts
    
  1. Instal versi spesifik:
    nvm install 18
    
  1. Beralih versi aktif:
    nvm use 18
    
  1. Atur versi default:
    nvm alias default 18
    
  1. Periksa versi:
    node -v
    npm -v
    

Keuntungan: Fleksibilitas dan Kontrol Maksimal

  • Beberapa versi dapat coexist dan diberalihkan secara instan
  • npm diinstal secara otomatis
  • Tidak memerlukan sudo, mengurangi masalah izin
  • Tidak memodifikasi lingkungan sistem, ideal untuk pengembangan

Kerugian: Pengaturan Awal Memerlukan Perhatian

  • nvm tidak akan berfungsi jika file konfigurasi shell tidak dimuat dengan benar
  • Diinstal per pengguna, bukan sistem-luas

Siapa yang Cocok dengan Metode Ini

  • Pengembang yang perlu beralih antara versi Node.js
  • Pengguna yang mengelola banyak proyek dengan persyaratan berbeda
  • Pemula yang ingin menghindari masalah terkait izin

6. Menggunakan npm dan yarn

Apa itu npm?

npm (Node Package Manager) adalah alat penting untuk mengelola paket Node.js. Ini memungkinkan Anda dengan mudah menginstal dan mengelola pustaka serta alat yang dipublikasikan oleh pengembang di seluruh dunia.

Ketika Node.js diinstal melalui APT, NodeSource, atau nvm, npm biasanya terinstal secara otomatis.

Periksa versi:
npm -v

Perintah npm Dasar

ActionCommand Example
Install a packagenpm install <package-name>
Install globallynpm install -g <package-name>
Uninstall a packagenpm uninstall <package-name>
Initialize a projectnpm init or npm init -y
List packagesnpm list or npm list -g

Apa itu yarn?

yarn adalah alternatif npm yang dikembangkan oleh Facebook, dirancang untuk manajemen paket yang lebih cepat dan lebih andal. Perintahnya sebagian besar kompatibel dengan npm.

Menginstal yarn (melalui npm)

npm install -g yarn

Verifikasi instalasi:

yarn -v

Perintah yarn Dasar

ActionCommand Example
Install a packageyarn add <package-name>
Global installyarn global add <package-name>
Uninstall a packageyarn remove <package-name>
Initialize a projectyarn init
List packagesyarn list or yarn global list

npm vs yarn: Mana yang Harus Anda Gunakan?

Comparisonnpmyarn
StandardIncluded with Node.jsRequires installation
SpeedStandardFaster with caching
Lock filepackage-lock.jsonyarn.lock
CompatibilityMostly compatible

npm modern (v7 dan selanjutnya) telah meningkat secara signifikan, jadi kedua opsi umumnya baik. Sebaiknya ikuti apa yang sudah digunakan oleh proyek atau tim Anda.

7. Kesalahan Umum dan Pemecahan Masalah

Masalah Umum dan Solusinya

node: command not found

Penyebab:
Node.js tidak terinstal dengan benar, atau PATH tidak diset. Ini sering terjadi setelah menginstal nvm tanpa memuat ulang konfigurasi shell.

Solusi:

  • Muat ulang file konfigurasi shell:
    source ~/.bashrc
    
  • Jika masalah tetap ada, keluar dan masuk kembali atau reboot

E: Unable to locate package nodejs

Penyebab:
Daftar paket APT sudah usang atau PPA yang tepat belum ditambahkan.

Solusi:

  • Perbarui daftar APT:
    sudo apt update
    
  • Jika menggunakan NodeSource, jalankan kembali skrip setup

npm ERR! permission denied

Penyebab:
Permission tidak cukup saat menginstal paket npm secara global.

Solusi:

  • Gunakan sudo (tidak selalu disarankan):
    sudo npm install -g <package-name>
    
  • Menggunakan nvm adalah praktik terbaik untuk menghindari masalah permission

nvm: command not found

Penyebab:
nvm sudah terinstal, tetapi konfigurasi shell belum dimuat.

Solusi:

  • Pastikan nvm di‑source dalam file konfigurasi shell Anda
  • Muat secara manual:
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    

Praktik Terbaik untuk Menghindari Masalah

  • Selalu verifikasi pengaturan PATH
  • Menggunakan nvm membantu menghindari sebagian besar masalah terkait lingkungan
  • Perhatikan kompatibilitas antara Ubuntu dan versi Node.js

8. Pertanyaan yang Sering Diajukan (FAQ)

Q1. Bagaimana cara memeriksa versi Node.js saya?

A. Jalankan perintah berikut di terminal:

node -v

Untuk memeriksa npm juga:

npm -v

Q2. Bagaimana cara menggunakan beberapa versi Node.js di Ubuntu?

A. Menggunakan nvm adalah pendekatan termudah dan paling aman. Setelah instalasi, Anda dapat beralih versi seperti ini:

nvm install 16
nvm use 16

Q3. Node.js yang diinstal melalui nvm tidak aktif. Mengapa?

A. Dalam kebanyakan kasus, file konfigurasi shell belum dimuat. Jalankan:

source ~/.bashrc

Atau, untuk Zsh:

source ~/.zshrc

Q4. Apa perbedaan antara npm dan yarn?

A. Fungsionalitas inti mereka serupa, tetapi yarn menawarkan instalasi lebih cepat dengan caching dan penguncian dependensi eksplisit melalui yarn.lock. npm modern telah meningkat secara signifikan, jadi kedua opsi bekerja dengan baik.

Q5. Bagaimana perbedaan Node.js, Deno, dan Bun?

A. Deno dan Bun adalah runtime alternatif yang dirancang untuk mengatasi keterbatasan Node.js.

  • Deno : Dukungan TypeScript native, keamanan yang ditingkatkan, pustaka standar bawaan
  • Bun : Eksekusi lebih cepat dan manajemen paket bawaan

Namun, Node.js tetap pilihan paling praktis karena ekosistem npm yang luas.

9. Kesimpulan: Pilih Metode Instalasi yang Tepat untuk Kebutuhan Anda

Ada beberapa cara untuk menginstal Node.js di Ubuntu, masing-masing dengan kekuatan dan kasus penggunaan yang jelas. Artikel ini memperkenalkan tiga metode representatif dan menjelaskan cara memilih yang paling sesuai.

APT (Ubuntu Official)

  • Kelebihan: Paling mudah dan aman
  • Kekurangan: Versi mungkin sudah usang
  • Direkomendasikan untuk: Pemula yang ingin memulai dengan cepat

NodeSource PPA

  • Kelebihan: Menginstal versi yang lebih baru sambil menggunakan APT
  • Kekurangan: Memerlukan penambahan PPA
  • Direkomendasikan untuk: Pengembang yang ingin versi terbaru yang stabil

nvm (Node Version Manager)

  • Kelebihan: Fleksibel dalam beralih versi dan lingkungan yang bersih
  • Kekurangan: Pengaturan sedikit lebih kompleks
  • Direkomendasikan untuk: Pengembang yang menangani beberapa proyek

Panduan ini juga membahas npm, yarn, dan tips pemecahan masalah umum. Meskipun instalasi Node.js mungkin tampak rumit pada awalnya, memilih metode yang tepat membuatnya mudah untuk membangun lingkungan pengembangan yang stabil di Ubuntu.

Jika Anda berencana untuk mengembangkan proyek Anda lebih lanjut, menggunakan nvm sebagai dasar akan membantu Anda berkembang ke pengembangan tim dan alur kerja CI/CD.