Kamu pasti pernah ngalamin ini: buka project lama, jalanin npm install, eh error karena Node versi beda. Atau lebih parah — upgrade Python buat satu project, project lain langsung berantakan. Global dependency itu jebakan batman yang hampir semua developer pernah kena.
Solusi klasiknya Docker. Tapi buat development sehari-hari, Docker itu overkill — startup lambat, volume mount di macOS lemot, dan kamu harus nulis Dockerfile cuma buat bilang "gue butuh Node 20 sama PostgreSQL 15". Ada cara yang lebih ringan: Devbox.
Apa Itu Devbox dan Kenapa Beda
Devbox adalah CLI tool dari Jetify yang bikin isolated shell environment per project, berbasis Nix package manager di balik layar. Kamu nggak perlu ngerti Nix — Devbox ngabstraksi semua kerumitannya.
Bedanya sama Docker:
- Nggak ada container overhead; prosesnya jalan langsung di host
- Shell activation hampir instan (< 1 detik)
- Satu file
devbox.jsondi-commit ke repo, semua anggota tim dapat environment yang sama - Bisa mix versi tool yang conflict tanpa virtual environment manual
Bedanya sama asdf atau nvm:
- Satu tool untuk semua bahasa dan tool (bukan plugin per bahasa)
- Environment benar-benar isolated — nggak "bocor" ke shell global
- Reproducible sampai level hash package, bukan cuma versi semver
Install Devbox
Satu command, jalan di macOS dan Linux:
curl -fsSL https://get.jetify.com/devbox | bash
Setelah install, verifikasi:
devbox version
# output: 0.13.x (atau lebih baru)
Gotcha pertama: Di Linux, Devbox butuh Nix daemon. Installer biasanya handle ini otomatis, tapi kalau kamu pakai distro dengan SELinux aktif (RHEL, Fedora), ada kemungkinan Nix daemon gagal start. Cek dengan
systemctl status nix-daemon. Kalau failed, jalaninsudo systemctl enable --now nix-daemon.
Setup Project Pertama
Misalnya kamu mau bikin backend sederhana dengan Node 20 + PostgreSQL 15 tanpa install apapun secara global.
mkdir my-api && cd my-api
devbox init
Ini bikin file devbox.json kosong:
{
"packages": [],
"shell": {
"init_hook": [],
"scripts": {}
}
}
Sekarang tambah packages yang kamu butuh:
devbox add nodejs@20 postgresql@15 git
Devbox langsung download dan resolve packages. devbox.json kamu sekarang jadi:
{
"packages": [
"nodejs@20",
"postgresql@15",
"git"
],
"shell": {
"init_hook": [],
"scripts": {}
}
}
Masuk ke isolated shell:
devbox shell
Verifikasi:
node --version # v20.x.x
psql --version # psql (PostgreSQL) 15.x
which node # /nix/store/... bukan /usr/local/bin
Keluar dari shell? Tinggal exit. Semua tool itu "hilang" dari PATH global kamu.
Jalanin PostgreSQL Lokal Tanpa Docker
Ini bagian yang paling sering bikin orang terkejut: Devbox bisa jalanin services — termasuk database — langsung di lokal tanpa container.
Tambahkan init hook dan script di devbox.json:
{
"packages": [
"nodejs@20",
"postgresql@15"
],
"shell": {
"init_hook": [
"export PGDATA=$PWD/.devbox/db",
"export PGHOST=$PWD/.devbox/run",
"mkdir -p $PGHOST"
],
"scripts": {
"db:init": "initdb --no-locale --encoding=UTF8 $PGDATA",
"db:start": "pg_ctl -D $PGDATA -l $PGDATA/postgres.log -o '-k $PGHOST' start",
"db:stop": "pg_ctl -D $PGDATA stop",
"db:create": "createdb -h $PGHOST myapp_dev"
}
}
}
Pertama kali setup:
devbox shell
devbox run db:init
devbox run db:start
devbox run db:create
Koneksi dari app kamu:
postgresql://localhost/myapp_dev?host=/path/to/project/.devbox/run
Atau set environment variable:
export DATABASE_URL="postgresql:///myapp_dev?host=$PGHOST"
Gotcha kedua: PostgreSQL via Unix socket (bukan TCP) — ini yang bikin
localhost:5432nggak work langsung. Kamu harus passhostparameter yang nunjuk ke directory socket. Beberapa ORM (Prisma, Sequelize) support ini; tinggal set di connection string. Kalau mau TCP biasa, tambah-p 5432dipg_ctloptions dan connect kelocalhost:5432.
Bikin .env Otomatis Saat Masuk Shell
Biar nggak harus export manual tiap buka terminal baru, manfaatin init_hook:
{
"shell": {
"init_hook": [
"export PGDATA=$PWD/.devbox/db",
"export PGHOST=$PWD/.devbox/run",
"export DATABASE_URL=\"postgresql:///myapp_dev?host=$PGHOST\"",
"export NODE_ENV=development",
"export PORT=3000",
"echo '✓ Dev environment ready'"
]
}
}
Setiap devbox shell, semua env var langsung tersedia. Nggak perlu source .env manual lagi.
Kalau kamu prefer file .env terpisah (misalnya buat kompatibilitas sama tool lain), bisa juga:
"init_hook": [
"[ -f .env ] && export $(grep -v '^#' .env | xargs)"
]
Devbox Scripts: Ganti npm scripts untuk Multi-Language Projects
Kalau project kamu campuran (misalnya backend Python + frontend Node), devbox scripts bisa jadi single entry point:
{
"packages": [
"nodejs@20",
"python@3.11",
"poetry"
],
"shell": {
"scripts": {
"install": "npm install && poetry install",
"dev": "concurrently 'npm run dev' 'poetry run uvicorn main:app --reload'",
"test": "npm test && poetry run pytest",
"lint": "npx eslint . && poetry run ruff check ."
}
}
}
Jalanin tanpa masuk shell dulu:
devbox run dev
devbox run test
Ini beda dari npm run — devbox run otomatis aktifin environment dulu sebelum jalanin command. Jadi CI/CD pipeline kamu bisa semudah:
# .github/workflows/ci.yml
steps:
- uses: actions/checkout@v4
- uses: jetify-com/devbox-install-action@v0.11.0
- run: devbox run test
Action devbox-install-action handle install Nix + Devbox + semua packages secara otomatis. Cache pun sudah built-in.
Commit devbox.json, Ignore .devbox/
Satu hal yang wajib diperhatiin soal gitignore:
# .gitignore
.devbox/db/
.devbox/run/
.devbox/virtenv/
# Tapi JANGAN ignore:
# devbox.json
# devbox.lock <-- ini penting untuk reproducibility
devbox.lock itu seperti package-lock.json — dia nyimpen exact Nix store hash untuk setiap package. Kalau kamu commit ini, teammate (atau diri kamu sendiri 6 bulan lagi) akan dapat bit-for-bit environment yang sama.
Kalau kamu skip commit devbox.lock, Devbox masih resolve ke versi yang sama selama channel Nix belum update — tapi nggak ada guarantee.
Integrasi dengan VS Code dan Cursor
Devbox punya integrasi shell yang smooth sama editor modern. Untuk VS Code/Cursor, tambah ini ke .vscode/settings.json project:
{
"terminal.integrated.defaultProfile.linux": "bash",
"terminal.integrated.profiles.linux": {
"Devbox Shell": {
"path": "devbox",
"args": ["shell"]
}
},
"terminal.integrated.defaultProfile.osx": "zsh",
"terminal.integrated.profiles.osx": {
"Devbox Shell": {
"path": "devbox",
"args": ["shell"]
}
}
}
Sekarang setiap buka terminal baru di VS Code dalam project itu, kamu langsung masuk devbox shell.
Alternatif lebih otomatis: pasang direnv dan buat .envrc:
devbox add direnv
devbox generate direnv
Ini generate file .envrc yang otomatis aktifin devbox environment setiap kamu cd ke folder project — tanpa perlu ketik devbox shell sama sekali.
direnv allow # sekali saja, untuk approve .envrc
Setelah itu, masuk folder = environment aktif. Keluar folder = environment nonaktif. Seamless.
Apa yang Gue Lakuin Sekarang
Gue sudah pindah semua project aktif ke Devbox. Setup yang gue pakai:
- Satu
devbox.jsonper project — masuk ke repo, di-commit bareng code - PostgreSQL dan Redis via Devbox services — nggak ada Docker di local machine gue sama sekali
- direnv untuk auto-activation — gue nggak pernah ketik
devbox shellsecara manual lagi devbox run testdi CI — GitHub Actions dengandevbox-install-action, cache hit rate ~90% jadi pipeline cepat
Kalau kamu mau mulai, langkah paling simpel: ambil satu project yang paling sering kamu kerjain, jalanin devbox init di sana, tambah packages yang biasanya kamu install global, commit hasilnya. Itu aja dulu.
Nanti kalau sudah nyaman, explore devbox services untuk management daemon yang lebih proper — Devbox punya built-in process manager yang bisa handle start/stop/status semua services sekaligus dengan devbox services up.
Search packages yang tersedia di search.nixos.org — hampir semua tool developer ada di sana, termasuk yang obscure sekalipun.