Kamu pasti pernah ngalamin ini: laptop baru, clone repo lama, terus npm install error karena versi Node beda. Atau lebih parah — kamu kerja di dua project sekaligus, satu butuh Python 3.9, satunya Python 3.11, dan pyenv kamu entah kenapa nggak mau nurut.
Itu masalah klasik yang biasanya dijawab dengan Docker. Tapi Docker punya overhead-nya sendiri: image gede, build lama, dan kalau kamu solo engineer yang kerja di laptop dengan RAM 8GB, ngejalanin Docker Compose sambil buka browser + IDE itu udah kerasa berat.
Ada alternatif yang lebih ringan: Devbox.
Devbox adalah CLI tool dari Jetpack.io yang bikin isolated dev environment berbasis Nix — tanpa container, tanpa VM. Setiap project punya dependency-nya sendiri, dan environment itu bisa di-reproduce persis sama di laptop lain hanya dari satu file devbox.json.
Kenapa Nix, Bukan Docker?
Nix adalah package manager yang deterministik. Artinya kalau kamu install nodejs@20.11.0 via Nix, semua orang yang pakai config yang sama bakal dapat binary yang identik — bukan cuma "versi yang sama", tapi hash yang sama.
Devbox duduk di atas Nix sebagai abstraction layer yang lebih ramah. Kamu nggak perlu belajar Nix language yang terkenal bikin kepala pusing. Cukup tulis devbox.json, sisanya Devbox yang urus.
Perbandingan kasar:
| Docker | Devbox | |
|---|---|---|
| Isolasi | Container (full OS layer) | Nix store (binary only) |
| Startup | Detik–menit | Sub-detik |
| RAM overhead | ~200MB+ per container | Hampir nol |
| Reproducibility | Butuh lock file + base image | Built-in via Nix hash |
| Learning curve | Medium | Rendah |
Devbox bukan pengganti Docker untuk production. Tapi untuk dev environment lokal, dia jauh lebih praktis.
Install Devbox
Satu command, jalan di macOS dan Linux:
curl -fsSL https://get.jetpack.io/devbox | bash
Script ini akan install Nix dulu kalau belum ada, terus install Devbox CLI di atasnya. Prosesnya sekitar 2–5 menit tergantung koneksi.
Verifikasi:
devbox version
# Output: 0.10.x (atau lebih baru)
Gotcha pertama: Kalau kamu pakai macOS Ventura ke atas, installer Nix kadang gagal karena permission issue di /nix. Solusinya: jalankan installer dengan flag --daemon:
sh <(curl -L https://nixos.org/nix/install) --daemon
Setelah Nix ter-install, ulangi install Devbox.
Setup Project Pertama
Misalnya kamu lagi bikin REST API sederhana pakai Node.js + PostgreSQL. Tanpa Devbox, kamu perlu install Node, npm, dan PostgreSQL di sistem — dan versinya bisa bentrok sama project lain.
Dengan Devbox, kita isolasi semua itu per-project:
mkdir my-api && cd my-api
devbox init
Ini bikin file devbox.json kosong:
{
"$schema": "https://raw.githubusercontent.com/jetpack-io/devbox/0.10.0/.schema/devbox.schema.json",
"packages": [],
"shell": {
"init_hook": [],
"scripts": {}
}
}
Sekarang tambah packages yang kamu butuh:
devbox add nodejs@20 postgresql@16 git
Devbox bakal download binary dari Nix store. First time agak lama, tapi setelah itu cached.
Lihat hasilnya di devbox.json:
{
"packages": [
"nodejs@20",
"postgresql@16",
"git"
]
}
Masuk ke dev shell:
devbox shell
Sekarang kamu ada di isolated environment. Cek versi:
node --version # v20.x.x
psql --version # psql (PostgreSQL) 16.x
Keluar dari shell? Ketik exit. Semua binary itu hilang dari PATH kamu — tapi tetap ada di Nix store, jadi next time masuk lagi instant.
Konfigurasi PostgreSQL Lokal Tanpa Docker
Ini bagian yang paling sering bikin orang masih milih Docker: database. Tapi Devbox punya cara untuk jalanin services langsung.
Tambahkan init hook dan script di devbox.json:
{
"packages": [
"nodejs@20",
"postgresql@16"
],
"shell": {
"init_hook": [
"export PGDATA=$PWD/.devbox/pg_data",
"export PGHOST=$PWD/.devbox/pg_run",
"export PGPORT=5432",
"mkdir -p $PGHOST"
],
"scripts": {
"pg:init": "initdb --username=dev --auth=trust",
"pg:start": "pg_ctl start -l $PWD/.devbox/pg.log -o '-k $PGHOST'",
"pg:stop": "pg_ctl stop",
"pg:createdb": "createdb -h $PGHOST myapp_dev"
}
}
}
Pertama kali setup:
devbox shell
devbox run pg:init # Inisialisasi cluster PostgreSQL
devbox run pg:start # Start PostgreSQL
devbox run pg:createdb # Buat database
Connect ke database:
psql -h $PGHOST -U dev myapp_dev
Data PostgreSQL tersimpan di .devbox/pg_data/ — di dalam folder project kamu. Commit .gitignore yang exclude folder itu:
echo ".devbox/pg_data/" >> .gitignore
echo ".devbox/pg_run/" >> .gitignore
echo ".devbox/pg.log" >> .gitignore
Gotcha kedua: pg_ctl butuh PGDATA ter-set dengan benar sebelum dijalankan. Kalau kamu buka terminal baru dan langsung devbox run pg:start tanpa masuk devbox shell dulu, environment variable-nya nggak ada dan command bakal error. Selalu masuk shell dulu, atau pakai devbox run yang otomatis load environment.
Satu File, Bisa Di-share ke Tim
Nah ini kekuatan utamanya. Commit devbox.json dan devbox.lock ke repo:
git add devbox.json devbox.lock
git commit -m "chore: add devbox environment config"
Temanmu (atau kamu sendiri di laptop baru) tinggal:
git clone <repo-url>
cd my-api
devbox shell
Devbox baca devbox.lock, download exact binary yang sama, dan environment langsung siap. Nggak ada "works on my machine" lagi.
File devbox.lock menyimpan Nix hash untuk setiap package:
{
"lockfile_version": "1",
"packages": {
"nodejs@20": {
"last_modified": "2024-01-15T10:00:00Z",
"resolved": "github:NixOS/nixpkgs/abc123#nodejs_20",
"source": "devbox-search",
"version": "20.11.0",
"systems": {
"aarch64-darwin": {
"store_path": "/nix/store/xxxx-nodejs-20.11.0"
},
"x86_64-linux": {
"store_path": "/nix/store/yyyy-nodejs-20.11.0"
}
}
}
}
}
Perhatikan ada entry terpisah untuk aarch64-darwin (Apple Silicon) dan x86_64-linux. Devbox otomatis pilih yang sesuai dengan arsitektur kamu.
Integrasi dengan VS Code
Devbox punya extension VS Code yang otomatis aktifkan dev shell ketika kamu buka project. Install dari marketplace:
ext install jetpack-io.devbox
Atau kamu bisa generate .env file dari environment Devbox untuk dipakai VS Code atau tools lain:
devbox shellenv --init-hook > .env.devbox
Kalau kamu pakai direnv (highly recommended untuk workflow ini), tambahkan ke .envrc:
# .envrc
eval "$(devbox shellenv --init-hook)"
Sekarang setiap kali kamu cd ke folder project, environment otomatis aktif. Nggak perlu ingat-ingat untuk jalankan devbox shell.
Gotcha ketiga: direnv perlu di-allow dulu setiap kali .envrc berubah:
direnv allow .
Kalau kamu lupa ini, direnv bakal block dan environment nggak aktif. Error message-nya agak cryptic — dia cuma bilang "direnv: error .envrc is blocked" tanpa penjelasan lebih lanjut.
Script Automation di devbox.json
Satu hal yang gue suka dari Devbox: kamu bisa define project scripts di devbox.json dan semua orang di tim pakai command yang sama.
Contoh untuk Node.js API project:
{
"packages": ["nodejs@20", "postgresql@16"],
"shell": {
"init_hook": [
"export PGDATA=$PWD/.devbox/pg_data",
"export PGHOST=$PWD/.devbox/pg_run",
"export DATABASE_URL=postgresql://dev@localhost/myapp_dev"
],
"scripts": {
"dev": "node --watch src/index.js",
"test": "node --test src/**/*.test.js",
"db:migrate": "node scripts/migrate.js",
"db:seed": "node scripts/seed.js",
"setup": "devbox run pg:init && devbox run pg:start && devbox run pg:createdb && npm install && devbox run db:migrate"
}
}
}
New developer onboarding jadi semudah:
git clone <repo>
cd my-api
devbox run setup # Satu command, semua siap
devbox run dev # Langsung coding
Bandingkan dengan README yang biasanya isinya 20 langkah manual yang setengahnya udah outdated.
Kapan Devbox Kurang Cocok
Jujur aja, Devbox bukan silver bullet:
- Windows: Nix nggak support Windows native. Kamu bisa pakai WSL2, tapi ada extra setup. Kalau tim kamu mix Windows dan Linux/Mac, perlu komunikasi ekstra.
- Package yang nggak ada di Nixpkgs: Nixpkgs punya 80.000+ packages, tapi kadang versi spesifik yang kamu butuh belum ada. Cek dulu di search.nixos.org.
- GUI apps: Devbox fokus ke CLI tools. Kalau kamu butuh database GUI atau tools dengan interface grafis, tetap install manual atau pakai Docker.
- Production: Devbox untuk dev environment, bukan deployment. Untuk production, tetap pakai Docker atau platform yang sesuai.
Yang Gue Lakuin Sekarang
Semua project gue sekarang punya devbox.json. Workflow-nya:
devbox initdi setiap project baru- Tambah packages via
devbox add— jangan install global kalau bisa dihindari - Define scripts untuk task yang sering diulang (dev, test, migrate)
- Commit
devbox.jsondandevbox.lockbareng source code - Pakai
direnvsupaya environment otomatis aktif
Hasilnya: gue bisa ganti laptop, clone semua repo, dan langsung coding dalam waktu kurang dari 30 menit — sebagian besar dihabiskan buat download Nix store pertama kali.
Kalau kamu mau explore lebih jauh, this guide on devbox.jetpack.io/docs menjelaskan plugin system-nya — ada pre-built plugins untuk PostgreSQL, Redis, MySQL, dan beberapa framework yang bikin setup jadi lebih singkat lagi.