Ngatur Dev Environment Pakai Nix Flakes

by Marcus Chen
Ngatur Dev Environment Pakai Nix Flakes

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:

  • inputs adalah dependency dari flake kamu — mirip package.json tapi untuk Nix ecosystem.
  • devShells.default adalah shell yang aktif ketika kamu jalanin nix develop.
  • shellHook adalah bash script yang dijalanin otomatis saat shell aktif. Di sini gue set environment variable dan auto-init PostgreSQL.
  • PGDATA dan PGHOST di-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:

  1. Buat flake.nix di awal project, define semua tools yang dibutuhin.
  2. Commit flake.nix dan flake.lock bareng initial commit.
  3. Buat .envrc dengan use flake, allow direnv.
  4. Tambah .envrc ke .gitignore kalau ada secret di dalamnya, atau commit kalau isinya cuma use 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.nix ke server dan jalanin nix develop di 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.