Problem: "Works on My Machine" yang Bikin Frustrasi
Kamu pernah ngalamin ini: clone repo, jalanin npm install, terus error karena Node-nya beda versi. Atau lebih parah — semua jalan di laptop kamu, tapi pas deploy ke server, tiba-tiba ada library yang missing. Klasik.
Solusi yang biasa dipakai: Docker. Tapi Docker punya overhead yang lumayan, terutama kalau kamu solo engineer yang cuma mau coding cepat tanpa harus spin up container dulu setiap sesi. Ada alternatif yang lebih elegan: Nix Flakes.
Nix Flakes bikin kamu bisa define dev environment secara deklaratif — semua dependency, tools, bahkan environment variable — dalam satu file flake.nix. Siapapun yang clone repo kamu bakal dapat environment yang identik, di macOS, Linux, bahkan WSL.
Kenapa Nix Flakes, Bukan Docker atau asdf?
Sebelum masuk ke tutorial, gue mau jujur soal trade-off:
Docker bagus untuk isolasi runtime, tapi buat dev environment sehari-hari, kamu harus mount volume, handle permission, dan startup-nya lambat. Bukan ideal buat iterasi cepat.
asdf atau mise lebih ringan, tapi dia cuma manage runtime versions — Node, Python, Ruby. Kalau kamu butuh ffmpeg, postgresql, redis, atau binary lain, kamu tetap install manual di luar asdf.
Nix Flakes manage semuanya: runtime, system tools, bahkan bisa jalanin service lokal seperti PostgreSQL — semua terisolasi per-project, tanpa polusi ke system-wide install.
Kekurangannya? Learning curve-nya nyata. Nix punya syntax yang agak aneh (functional language), dan error message-nya kadang kripik. Tapi sekali paham polanya, kamu bakal addicted.
Setup Awal: Install Nix
Kalau belum ada Nix di mesin kamu, install dulu pakai Determinate Systems installer — ini yang paling smooth di 2024, support macOS dan Linux:
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
Setelah install, aktifkan Flakes (kalau belum auto-aktif):
mkdir -p ~/.config/nix
echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
Restart terminal, lalu verifikasi:
nix --version
# nix (Nix) 2.18.x
Struktur flake.nix yang Gue Pakai
Sekarang masuk ke bagian inti. Buat file flake.nix di root project kamu. Contoh ini untuk project Node.js + PostgreSQL:
{
description = "Dev environment untuk project Node.js + PostgreSQL";
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
flake-utils.url = "github:numtide/flake-utils";
};
outputs = { self, nixpkgs, flake-utils }:
flake-utils.lib.eachDefaultSystem (system:
let
pkgs = nixpkgs.legacyPackages.${system};
in
{
devShells.default = pkgs.mkShell {
buildInputs = with pkgs; [
nodejs_20
nodePackages.pnpm
postgresql_15
redis
just # task runner, pengganti Makefile
httpie # HTTP client buat testing API
];
shellHook = ''
export PGDATA="$PWD/.pgdata"
export PGHOST="$PWD/.pg"
export DATABASE_URL="postgresql://localhost/myapp_dev"
# Auto-init PostgreSQL kalau belum ada
if [ ! -d "$PGDATA" ]; then
echo "Initializing local PostgreSQL..."
initdb --no-locale -E UTF8 -D "$PGDATA"
mkdir -p "$PGHOST"
fi
echo "Dev environment ready. Jalanin 'pg_ctl start' untuk start PostgreSQL."
'';
};
}
);
}
Beberapa hal yang perlu diperhatikan di sini:
inputsadalah dependency dari flake kamu — mirippackage.jsontapi untuk Nix ecosystem.devShells.defaultadalah shell yang aktif ketika kamu jalaninnix develop.shellHookadalah bash script yang dijalanin otomatis saat shell aktif. Di sini gue set environment variable dan auto-init PostgreSQL.PGDATAdanPGHOSTdi-set ke folder lokal project, jadi PostgreSQL-nya per-project, nggak ganggu instalasi PostgreSQL lain di sistem.
Untuk masuk ke dev shell:
nix develop
Pertama kali bakal lama karena Nix download semua dependency. Selanjutnya? Instant, karena ada cache.
Integrasi direnv: Shell Otomatis Aktif
Ngetik nix develop setiap buka terminal itu ribet. Solusinya: direnv.
Install direnv:
# macOS
brew install direnv
# atau lewat Nix sendiri
nix profile install nixpkgs#direnv
Tambah ke shell config kamu (~/.zshrc atau ~/.bashrc):
eval "$(direnv hook zsh)"
# atau untuk bash:
# eval "$(direnv hook bash)"
Buat file .envrc di root project:
use flake
Lalu allow:
direnv allow
Sekarang setiap kali kamu cd ke folder project, dev environment langsung aktif otomatis. Keluar dari folder, environment balik ke normal. Ini yang bikin workflow-nya smooth banget.
Gotcha yang gue hit: direnv versi lama kadang nggak support use flake out of the box. Pastikan direnv kamu versi 2.30+ atau install nix-direnv untuk integrasi yang lebih proper:
# Tambah ini ke ~/.config/direnv/direnvrc
source "$(nix eval --raw nixpkgs#nix-direnv)/share/nix-direnv/direnvrc"
Menambah Tools yang Lebih Spesifik
Misalnya kamu kerja di project yang butuh ffmpeg untuk video processing, atau awscli untuk deploy:
buildInputs = with pkgs; [
nodejs_20
nodePackages.pnpm
postgresql_15
redis
# Tambahan tools
ffmpeg
awscli2
terraform
kubectl
];
Mau pin ke versi spesifik yang beda dari nixpkgs-unstable? Kamu bisa tambahin input lain:
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
nixpkgs-stable.url = "github:NixOS/nixpkgs/nixos-23.11"; # versi stable
flake-utils.url = "github:numtide/flake-utils";
};
Terus di outputs, kamu bisa mix package dari dua channel berbeda:
outputs = { self, nixpkgs, nixpkgs-stable, flake-utils }:
flake-utils.lib.eachDefaultSystem (system:
let
pkgs = nixpkgs.legacyPackages.${system};
stable = nixpkgs-stable.legacyPackages.${system};
in
{
devShells.default = pkgs.mkShell {
buildInputs = [
pkgs.nodejs_20 # dari unstable
stable.postgresql_15 # dari stable, lebih predictable
];
};
}
);
Commit flake.lock ke Git
Ini penting: setelah pertama kali jalanin nix develop, Nix akan generate file flake.lock. File ini adalah lockfile yang pin semua dependency ke commit hash yang spesifik — mirip package-lock.json atau Cargo.lock.
Commit flake.lock ke repo kamu. Ini yang bikin environment kamu benar-benar reproducible. Siapapun yang clone repo dan jalanin nix develop bakal dapat exact versi yang sama.
Update dependency kalau mau:
nix flake update # update semua inputs
nix flake update nixpkgs # update input spesifik
Lalu commit flake.lock yang baru.
Gotcha dan Tips dari Pengalaman Nyata
1. macOS dan Linux punya package yang beda
Beberapa package cuma available di Linux, atau nama-nya beda. Kalau kamu develop di macOS tapi deploy di Linux, gunakan flake-utils.lib.eachDefaultSystem seperti contoh di atas — dia handle multi-platform dengan baik.
2. Error "attribute 'X' missing"
Ini error paling sering. Artinya nama package yang kamu tulis nggak ada di nixpkgs. Cari nama yang benar di search.nixos.org. Misalnya python3 bukan python, nodejs_20 bukan node20.
3. shellHook nggak jalan di direnv
Kalau pakai nix-direnv, shellHook dari mkShell tetap jalan. Tapi kalau pakai plain use flake, kadang nggak. Solusinya: pindah logic initialization ke file .envrc langsung:
# .envrc
use flake
# Logic yang biasanya di shellHook
export DATABASE_URL="postgresql://localhost/myapp_dev"
4. Cache Nix bisa makan storage
Nix store ada di /nix/store dan bisa gede. Bersihkan secara berkala:
nix store gc
nix-collect-garbage -d # hapus semua generasi lama
Yang Gue Lakuin Sekarang
Setup ini sekarang gue pakai di semua project — dari side project kecil sampai yang lumayan kompleks. Workflow-nya kira-kira:
- Buat
flake.nixdi awal project, define semua tools yang dibutuhin. - Commit
flake.nixdanflake.lockbareng initial commit. - Buat
.envrcdenganuse flake, allow direnv. - Tambah
.envrcke.gitignorekalau ada secret di dalamnya, atau commit kalau isinya cumause flake.
Langkah lanjutan yang bisa kamu explore:
devenv.sh— wrapper di atas Nix Flakes yang syntax-nya lebih friendly, cocok kalau kamu mau manfaat Nix tapi nggak mau nulis Nix language dari scratch.- Nix Home Manager — kalau kamu mau manage dotfiles dan user-level config pakai Nix juga.
- Remote dev environment — kamu bisa push
flake.nixke server dan jalaninnix developdi sana untuk environment yang identik dengan lokal.
Sekali kamu terbiasa dengan pola ini, balik ke setup manual rasanya seperti debugging tanpa log. Semua ada di satu file, version-controlled, dan reproducible. Untuk memastikan performa aplikasi kamu optimal, kamu juga bisa mempertimbangkan WordPress object cache jika kamu bekerja dengan WordPress, atau mengoptimalkan Core Web Vitals untuk performa situs yang lebih baik.