Jalankan Dev Environment Lokal dengan Devbox

by Marcus Chen
Jalankan Dev Environment Lokal dengan Devbox

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.json di-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, jalanin sudo 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:5432 nggak work langsung. Kamu harus pass host parameter yang nunjuk ke directory socket. Beberapa ORM (Prisma, Sequelize) support ini; tinggal set di connection string. Kalau mau TCP biasa, tambah -p 5432 di pg_ctl options dan connect ke localhost: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:

  1. Satu devbox.json per project — masuk ke repo, di-commit bareng code
  2. PostgreSQL dan Redis via Devbox services — nggak ada Docker di local machine gue sama sekali
  3. direnv untuk auto-activation — gue nggak pernah ketik devbox shell secara manual lagi
  4. devbox run test di CI — GitHub Actions dengan devbox-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.