Developer yang memegang lebih dari dua proyek Node.js cepat atau lambat akan mengalami hal yang sama. Proyek klien lama masih butuh Node.js 22, produk utama sudah di 24, dan proyek baru mulai di 26 yang resmi LTS sejak akhir Oktober. Node.js bawaan package manager sistem operasi tidak bisa melayani ketiganya, dan biasanya versinya malah lebih tua dari semuanya. nvm, singkatan dari Node Version Manager, adalah jawaban yang paling umum untuk masalah ini. Sayangnya nvm juga sering dipakai di tempat yang bukan peruntukannya, terutama server production. Artikel ini membahas dua sisi tersebut: cara memakai nvm dengan benar di mesin development, dan kapan sebaiknya berhenti memakainya.
Cara Kerja nvm
nvm adalah shell script, bukan program. Saat diinstall, nvm menambahkan beberapa baris ke profil shell yang memuat fungsi bernama nvm setiap kali terminal dibuka. Setiap versi Node.js yang Anda install diekstrak ke foldernya sendiri di ~/.nvm/versions/node, dan nvm use hanya menaruh folder yang tepat di urutan paling depan PATH untuk shell yang sedang aktif. Tidak ada yang dipasang di level sistem, tidak perlu sudo, dan terminal yang menjalankan nvm use 22 tidak mengganggu terminal lain yang sedang memakai Node.js 24.
Desain ini menjelaskan hampir semua kelebihan dan kekurangan nvm. Untuk developer yang bekerja di terminal, nvm sederhana dan aman. Tapi artinya nvm hanya ada di shell yang memuat profil Anda, dan di situlah masalahnya ketika Node.js dijalankan oleh systemd, cron, atau user lain.
Cara Install nvm di Linux, macOS, dan WSL
Rilis terbaru adalah v0.41.0 yang terbit 4 November 2026. Cara install resminya memakai install script dari repository nvm. Homebrew memang punya formula nvm, tapi maintainer nvm tidak mendukung cara itu dan meminta pengguna nvm dari Homebrew untuk memasang ulang lewat script sebelum melaporkan bug.
- 1Pastikan curl atau wget dan git sudah terpasang. Di Ubuntu atau Debian yang masih baru, jalankan sudo apt install curl git.
- 2Jalankan install script dengan versi tertulis di URL: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash. Dengan versi yang dikunci, Anda tahu persis script mana yang dijalankan. Kalau tidak nyaman menjalankan script langsung ke bash, unduh dulu lalu baca isinya.
- 3Tutup terminal lalu buka lagi, atau muat ulang profil dengan source ~/.bashrc atau source ~/.zshrc. Script tadi menambahkan dua baris yang mengatur NVM_DIR dan memuat nvm.sh.
- 4Cek dengan command -v nvm, hasilnya harus nvm. Perintah which nvm yang biasa dipakai tidak menampilkan apa-apa, karena nvm adalah fungsi shell, bukan file di PATH.
- 5Install Node.js, misalnya nvm install --lts untuk lini LTS terbaru, atau nvm install 24 untuk 24.x terbaru. Versi pertama yang diinstall otomatis menjadi default untuk terminal baru.
Menjalankan install script yang sama dengan versi lebih baru di URL akan meng-update nvm. Versi Node.js yang sudah terpasang tetap aman.
Perintah yang Paling Sering Dipakai
| Perintah | Fungsinya |
|---|---|
| nvm install 24 | Mengunduh 24.x terbaru, mengecek checksum SHA-256, lalu langsung memakainya |
| nvm install --lts | Memasang rilis LTS terbaru, saat ini 26.13.1 |
| nvm use 22 | Mengganti terminal aktif ke 22.x terbaru yang sudah terpasang |
| nvm ls | Menampilkan versi terpasang, versi yang aktif, dan versi default |
| nvm ls-remote --lts | Menampilkan semua versi LTS yang tersedia di nodejs.org |
| nvm alias default 24 | Mengatur versi yang dipakai setiap kali terminal baru dibuka |
| nvm current | Menampilkan versi yang aktif di terminal ini |
| nvm which 24 | Menampilkan path lengkap binary node untuk versi tersebut |
| nvm uninstall 20 | Menghapus versi beserta package global-nya |
| nvm cache clear | Menghapus arsip unduhan yang disimpan nvm di cache |
Penulisan versi bisa longgar. 24 berarti 24.x terbaru yang terpasang atau tersedia, 24.22 mempersempit ke lini minor itu, dan 24.22.3 berarti versi persis. Ada juga alias: node untuk rilis terbaru, lts/* untuk LTS terbaru, dan lts/krypton untuk lini 24.x berdasarkan nama kodenya.
Kunci Versi per Proyek dengan .nvmrc
Fitur nvm yang paling berguna justru bukan perintah, melainkan sebuah file. Buat file bernama .nvmrc di root repository yang berisi satu versi, misalnya 24, lalu commit. Setelah itu, nvm use atau nvm install tanpa argumen akan membaca file tersebut, termasuk dari folder induk, dan beralih ke versi yang dibutuhkan proyek. Anggota tim baru cukup clone repository, jalankan nvm install, dan langsung memakai Node.js yang benar tanpa perlu bertanya ke siapa pun.
Menulis 24 atau 24.22.3 adalah pilihan yang perlu dipikirkan. Versi major saja membuat setiap developer bisa mendapat patch keamanan tanpa perlu commit, dan ini cocok untuk kebanyakan aplikasi. Versi persis membuat semua orang memakai binary yang sama, yang penting untuk native addon atau saat mengejar bug yang muncul di antara dua rilis patch, tapi harus ada yang meng-update file itu setiap kali ada rilis keamanan. Sepanjang 2026 sudah ada enam rilis seperti itu, jadi kami biasanya menulis versi major saja di .nvmrc dan baru mengunci versi persis di image Docker.
.nvmrc dibaca oleh banyak tool selain nvm. Action setup-node di GitHub Actions menerima node-version-file: .nvmrc, fnm membacanya, Netlify membacanya, dan mise bisa diatur untuk membacanya. Karena itu .nvmrc cocok dijadikan satu-satunya tempat mencatat versi. Tambahkan field engines di package.json, misalnya "node": ">=24", kalau Anda ingin npm memberi peringatan saat ada yang install dependency di versi yang salah, dan engine-strict=true di .npmrc kalau peringatan itu harus menjadi error.
nvm tidak otomatis berganti versi saat Anda masuk ke sebuah folder. Kalau ingin begitu, README nvm menyediakan hook singkat untuk bash, zsh, dan fish yang memanggil nvm use setiap kali direktori berubah. Hook itu berfungsi, tapi berjalan di setiap cd, jadi di mesin yang lambat mungkin terasa.
Perubahan di nvm 0.41.0
Waktu rilis ini bukan kebetulan. Mulai Node.js 27, proyek Node.js berpindah dari dua rilis major per tahun menjadi satu, dan setiap major menjalani fase alpha sekitar enam bulan sebelum rilis stabil pertamanya. Alpha pertama Node.js 27 keluar akhir Oktober, dan build alpha dipublikasikan di nodejs.org berdampingan dengan rilis biasa. nvm versi lama bisa menganggapnya sebagai Node.js terbaru, sehingga nvm install node berpotensi memasang versi alpha.
- Rilis alpha sekarang tidak ikut dipilih secara default. nvm install node, nvm install 27, dan nvm ls-remote mengabaikannya kecuali Anda memintanya dengan --only=alpha.
- nvm mencatat status LTS setiap versi, jadi nvm alias default --lts node menunjuk ke LTS terbaru yang terpasang, bukan versi paling baru secara umum.
- nvm ls-remote menandai versi yang akan dipasang oleh alias node dan versi yang dirujuk alias buatan Anda sendiri.
- Beberapa perbaikan memperketat proses unduhan, antara lain arsip baru disimpan ke cache setelah checksum-nya lolos, dan teks dari mirror tidak lagi masuk ke aritmetika shell.
Kalau Anda memasang nvm satu atau dua tahun lalu, sebaiknya update. Jalankan install script dengan v0.41.0 di URL, versi Node.js yang sudah ada tidak akan hilang.
Masalah yang Sering Muncul
- nvm: command not found setelah install. Script menambahkan barisnya ke file profil yang tidak dibaca shell Anda, misalnya ~/.bashrc padahal terminal membuka login shell yang membaca ~/.bash_profile. Salin dua baris tersebut ke file yang benar, atau atur PROFILE ke path yang tepat lalu jalankan install script lagi.
- Package global hilang setelah ganti versi. Setiap versi Node.js punya node_modules global sendiri, jadi package yang diinstall dengan npm install -g di versi 22 tidak ada di 24. Pakai nvm install 26 --reinstall-packages-from=24 saat pindah versi, atau tulis package yang selalu dibutuhkan, satu per baris, di $NVM_DIR/default-packages.
- pnpm atau Yarn tidak jalan di Node.js 26. Corepack tidak lagi dibundel bersama Node.js 26, sehingga corepack enable gagal. Install pnpm atau Corepack secara eksplisit di setiap versi, atau masukkan ke default-packages supaya ikut terpasang di setiap versi baru.
- Terminal terasa lebih lama terbuka. Memuat nvm.sh menambah jeda yang terasa di laptop yang lebih lambat atau di WSL. Memuat nvm dengan opsi --no-use membantu, begitu juga plugin lazy loading untuk zsh. Kalau masih mengganggu, itulah alasan utama untuk mencoba fnm.
- Peringatan bahwa nvm tidak kompatibel dengan opsi prefix npm. Ada yang mengisi prefix di ~/.npmrc, biasanya sisa usaha lama supaya npm install -g tidak perlu sudo. Hapus baris itu, atau jalankan nvm use --delete-prefix dengan versi yang dimaksud.
- Install versi lama makan waktu sangat lama. Kalau nodejs.org tidak menyediakan binary untuk platform Anda, misalnya versi yang sangat lama di Apple Silicon, nvm akan compile dari source. Atur NVM_NO_SOURCE_FALLBACK=1 kalau Anda lebih memilih error daripada menunggu build dua puluh menit.
- Disk pelan-pelan penuh. Setiap versi yang terpasang memakan lebih dari seratus megabyte. Sesekali jalankan nvm ls dan hapus versi yang sudah tidak dipakai proyek mana pun.
Di Windows, nvm sama sekali tidak berjalan di PowerShell atau cmd. nvm bisa dipakai di dalam WSL, dan memang itu yang kami sarankan untuk development Node.js di Windows, karena file watching dan native module berperilaku sama seperti di server Linux tempat kode nantinya berjalan. nvm-windows adalah proyek terpisah dengan nama dan perintah yang mirip, tapi cara kerjanya berbeda: ia mengganti satu link di level sistem, sehingga nvm use mengubah versi di semua terminal yang terbuka sekaligus.
Kenapa nvm Bermasalah di Server
Banyak tutorial deploy Node.js ke VPS dimulai dengan install nvm, dan di awal semuanya berjalan lancar karena orang yang mengikutinya sedang berada di shell interaktif. Masalahnya baru muncul belakangan, dan biasanya di saat yang paling tidak tepat, seperti ketika server reboot atau ada rilis keamanan.
- systemd dan cron tidak membaca .bashrc. Unit file dengan ExecStart=node server.js gagal dengan pesan node not found, lalu orang menempelkan path lengkap seperti /home/deploy/.nvm/versions/node/v24.22.2/bin/node. Setelah nvm install berikutnya, path itu masih menunjuk ke binary lama, dan service tetap berjalan di versi yang belum di-patch.
- PM2 menyimpan PATH yang berlaku saat pm2 startup dijalankan. Setelah Node.js di-upgrade, PM2 saat boot tetap memakai versi lama sampai ada yang menjalankan pm2 unstartup, pm2 startup, dan pm2 save lagi.
- sudo node dan user lain tidak bisa melihatnya. nvm berada di folder home milik satu user. Root, user deploy lain, atau agent monitoring tidak akan menemukan Node.js, atau malah menemukan versi lain dari package sistem.
- Sulit memastikan versi yang benar-benar berjalan. Setelah beberapa kali upgrade, satu server bisa punya empat versi Node.js, alias default yang menunjuk ke salah satunya, dan service yang terkunci ke versi lain. Dari pengalaman kami, inilah penyebab paling umum server masih rentan padahal tim merasa sudah melakukan patch.
Kalau untuk sementara nvm masih harus ada di server, batasi risikonya. Pakai satu user khusus untuk aplikasi. Di systemd, jalankan aplikasi lewat script nvm-exec yang ikut terpasang bersama nvm, misalnya ExecStart=/home/deploy/.nvm/nvm-exec node server.js dengan Environment=NODE_VERSION=24, supaya unit mengikuti 24.x terbaru yang terpasang, bukan path yang terkunci. Catat process.version ke log saat aplikasi start, supaya versi yang benar-benar berjalan bisa dicek dari log.
Untuk server baru, pilih salah satu cara di bawah. Semuanya menaruh Node.js di path sistem yang tetap, sehingga bisa dilihat oleh semua user dan service manager.
| Cara | Cocok untuk | Yang perlu diperhatikan |
|---|---|---|
| Image Docker seperti node:24-bookworm-slim | Sebagian besar deployment baru, dan tim yang sudah memakai container | Image harus di-build ulang setiap ada rilis keamanan Node.js, kalau tidak versinya tetap yang lama |
| Repository apt atau yum dari NodeSource | VPS yang menjalankan satu atau dua aplikasi langsung di host | Satu versi major per server, dan upgrade datang lewat apt upgrade |
| Binary tarball resmi di /opt dengan link di /usr/local/bin | Server yang tidak punya akses internet ke repository package | Update sepenuhnya manual, jadi harus masuk ke checklist |
| Node.js dari package bawaan distro | Tool internal yang tidak masalah memakai versi lebih lama | Sering tertinggal beberapa major, misalnya Ubuntu 24.04 masih membawa Node.js 18 |
nvm Dibandingkan fnm, Volta, mise, dan n
| Tool | Cara kerja | Status per November 2026 | Cocok kalau |
|---|---|---|---|
| nvm | Shell script yang mengubah PATH per terminal | Aktif dikembangkan, v0.41.0 | Anda ingin opsi yang dokumentasinya paling banyak di Linux, macOS, atau WSL |
| fnm | Satu binary Rust, membaca .nvmrc dan .node-version | Masih dirawat, v1.39.0 dari Maret 2026 | Waktu buka terminal penting, atau Anda butuh dukungan Windows native |
| Volta | Shim yang memilih versi berdasarkan package.json | Tidak lagi dirawat, pembuatnya menyarankan pindah ke mise | Hanya untuk setup lama yang masih berjalan, hindari untuk setup baru |
| mise | Mengelola Node.js sekaligus Python, Go, Java, dan tool lain | Sangat aktif, rilis beberapa kali sebulan | Proyek memakai beberapa bahasa dan Anda ingin satu tool dan satu file konfigurasi |
| n | Mengganti satu Node.js sistem di /usr/local | Masih dirawat, sengaja dibuat sederhana | Mesin hanya butuh satu versi dalam satu waktu dan Anda ingin upgrade yang mudah |
Untuk tim, pilihan tool tidak sepenting kesepakatan untuk memakai satu sumber versi. Setengah tim memakai nvm dan setengahnya fnm tidak masalah, selama keduanya membaca .nvmrc yang sama. Yang bikin repot adalah proyek yang punya .nvmrc, field volta di package.json, dan file .tool-versions yang masing-masing menyebut versi berbeda.
Rekomendasi Kami
- Di mesin developer, pakai nvm atau fnm. Keduanya bagus, dan nvm punya paling banyak jawaban kalau ada masalah.
- Commit .nvmrc berisi versi major ke setiap repository Node.js, dan arahkan CI ke file yang sama daripada menulis versi lagi di workflow.
- Untuk proyek baru, mulai di Node.js 26 yang saat ini Active LTS. Proyek di 24 masih didukung sampai April 2028, sedangkan proyek di 22 perlu merencanakan pindah sebelum end of life pada 30 April 2027.
- Di server production, jalankan Node.js dari image Docker atau package sistem, bukan nvm, dan pastikan versi yang benar-benar berjalan bisa dicek dari luar.
- Setiap ada rilis keamanan Node.js, update juga versi di mesin developer dengan nvm install 24 atau lini yang Anda pakai, supaya pengujian lokal sama dengan production.
nvm adalah tool kecil yang menyelesaikan masalah nyata dengan baik, selama ia tetap berada di mesin tempat manusia mengetik perintah. Kalau tim Anda masih deploy Node.js dengan nvm dan ingin pindah ke container atau setup server yang lebih rapi, tim cloud dan DevOps kami bisa membantu migrasinya, dan training DevOps kami membahas praktik yang sama untuk tim yang ingin mengelolanya sendiri.
Poin penting
- nvm adalah fungsi shell yang memasang setiap versi Node.js di folder home dan mengganti PATH per terminal, tanpa sudo.
- Install dengan script dari repository nvm yang dikunci ke v0.41.0, lalu cek dengan command -v nvm.
- Commit .nvmrc berisi versi major di setiap proyek. nvm, fnm, GitHub Actions, dan Netlify semuanya membacanya.
- nvm 0.41.0 mengabaikan rilis alpha Node.js secara default, penting karena Node.js 27 sedang dalam fase alpha.
- Package global, termasuk pnpm karena Corepack tidak lagi dibundel di Node.js 26, terpisah untuk setiap versi.
- Di server production, utamakan Docker atau package sistem. Path nvm, systemd, cron, dan PM2 sering membuat server tertinggal di versi lama.


