Pernah membuka repo lama dan menemukan file .env masih tersimpan rapi di sana, lengkap dengan password database yang sampai sekarang masih dipakai? Padahal git menyimpan setiap versi file selamanya. Hapus .env dari commit terbaru, isinya tetap ada di commit lama dan di setiap clone yang pernah dibuat orang lain. Oke, lanjuutt.. Di artikel ini kita enkripsi .env dengan SOPS dan age, lalu menyimpannya di git tanpa perlu menyembunyikan repo-nya.
SOPS (Secrets OPerationS) mengacak nilai, bukan seluruh file. Nama variabel tetap terbaca, jadi git diff masih bisa menunjukkan variabel mana yang berubah, sementara isinya tidak bisa dibaca siapa pun tanpa kunci privat yang cocok. Versi terbaru saat artikel ini ditulis adalah SOPS 3.13.3, dirilis 23 Juli 2026, dan semuanya berjalan lokal di VPS tanpa layanan pihak ketiga.
Kenapa .env di Git Tetap Berbahaya Walau Repo-nya Privat
Repo privat hanya menutup satu pintu. Tiga jalur lain tetap terbuka:
- Riwayat git tidak bisa diedit dengan cara biasa. Satu commit yang tidak sengaja membawa
.envsudah cukup; file itu ikut terkirim ke semua clone, fork, dan mirror sejak saat itu. - Backup dan salinan lokal. Arsip repo dan snapshot VPS menyimpan riwayat yang sama.
- Log CI/CD. Pipeline yang mencetak isi environment saat debug menaruh nilainya di log, dan log disimpan lebih lama dari yang kita kira.
Menambahkan .env ke .gitignore membantu, tapi belum menjawab pertanyaan berikutnya: bagaimana kalau konfigurasi itu memang perlu disimpan di repo supaya deployment bisa diulang dari nol? Di situ SOPS dipakai.
Cara Kerja SOPS: Nilai Dienkripsi, Nama Variabel Tetap Terbaca
SOPS membaca YAML, JSON, ENV, dan INI sebagai pohon data, lalu mengenkripsi nilai per nilai. Hasilnya untuk file .env seperti ini (disingkat):
DB_HOST=db.internal
DB_PASSWORD=ENC[AES256_GCM,data:9xQ=,iv:...,tag:...,type:str]
API_TOKEN=ENC[AES256_GCM,data:K2w=,iv:...,tag:...,type:str]
Nama variabel, komentar, dan urutan baris utuh. Di bagian bawah ada metadata sops yang mencatat penerima kunci dan MAC untuk mendeteksi perubahan manual. Kuncinya sendiri disimpan di luar file: kita memakai age, alat enkripsi file modern yang oleh dokumentasi SOPS disebut lebih disarankan daripada PGP. age memakai pasangan kunci X25519, satu recipient publik untuk mengenkripsi dan satu identitas privat untuk mendekripsi.
Langkah 1: Pasang age dan SOPS di VPS
age ada di repo Debian. Di Debian 13 (trixie) versinya 1.2.1, di testing dan unstable sudah 1.3.2, jadi cek dulu apa yang masuk:
sudo apt update
sudo apt install age
age --version && age-keygen --version
SOPS beda cerita: paket bernama sops tidak ada di repo Debian. Pencarian di packages.debian.org untuk nama sops hanya menemukan orca-sops, plugin pembaca layar yang tidak berhubungan. Ambil paket .deb resmi dari halaman rilis proyeknya:
cd /tmp
curl -LO https://github.com/getsops/sops/releases/download/v3.13.3/sops_3.13.3_amd64.deb
sudo apt install ./sops_3.13.3_amd64.deb
sops --version
Untuk arm64 ganti namanya jadi sops_3.13.3_arm64.deb. Rilis yang sama juga menyediakan RPM dan binary statis.
Langkah 2: Satu Kunci age per Pihak, Bukan Satu Kunci untuk Semua
Ini bagian yang paling sering dilewatkan, dan penyebab utama kunci bocor: satu identitas dipakai semua orang dan semua layanan. Bikin satu identitas per pihak yang perlu mendekripsi, satu untuk server produksi, satu untuk staging, satu untuk job CI. Dengan begitu, memutus akses satu pihak tidak berarti mengganti kunci semua orang.
mkdir -p ~/.config/sops/age
age-keygen -o ~/.config/sops/age/keys.txt
chmod 600 ~/.config/sops/age/keys.txt
grep "public key" ~/.config/sops/age/keys.txt
age-keygen menulis baris komentar berisi public key (age1...) dan baris AGE-SECRET-KEY-... yang merupakan identitas privatnya. Yang boleh masuk repo hanya public key. Identitas privat tinggal di VPS dengan izin 600, dan untuk job CI disimpan di secret store pipeline.
SOPS mencari identitas di $XDG_CONFIG_HOME/sops/age/keys.txt atau ~/.config/sops/age/keys.txt. Ketiganya bisa diganti: SOPS_AGE_KEY_FILE untuk path berkas, SOPS_AGE_KEY untuk isi kunci langsung, dan SOPS_AGE_KEY_CMD untuk perintah yang mencetak kunci. Di server, pakai SOPS_AGE_KEY_FILE dengan path absolut, karena layanan systemd tidak selalu punya HOME yang sama dengan shell kita.
Langkah 3: Tulis .sops.yaml di Root Repo
File ini adalah peta: file mana dienkripsi untuk kunci siapa. Tanpanya, setiap perintah harus membawa flag --age yang panjang.
creation_rules:
# regex pertama yang cocok yang dipakai, catch-all taruh paling bawah
- path_regex: secrets/.*\.env(\.enc)?$
age: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p
Beberapa aturan di balik layar:
- Namanya harus
.sops.yaml. Varian.sops.ymltidak otomatis ditemukan; sebut eksplisit lewat--configkalau memakainya. - Pencariannya dimulai dari working directory, bukan dari folder file yang sedang dienkripsi. Jalankan
sopsdari root repo supaya tidak berakhir dengan “config file not found”. path_regexdihitung relatif terhadap folder.sops.yaml.- Aturan pertama yang cocok yang menang. Catch-all tanpa
path_regexdi urutan atas membuat semua aturan di bawahnya tidak pernah terpakai. encrypted_regexdipakai untuk YAML/JSON yang hanya perlu mengenkripsi sebagian nilai; untuk file.envseluruh nilai dienkripsi, jadi tidak perlu.
Langkah 4: Enkripsi .env dengan SOPS
Simpan plaintext di lokasi yang tidak ikut git, lalu hasil enkripsinya yang masuk repo:
mkdir -p secrets
cp /root/app/.env secrets/app.env
sops encrypt --input-type dotenv --output-type dotenv secrets/app.env > secrets/app.env.enc
rm secrets/app.env
--input-type dan --output-type diisi eksplisit karena SOPS menebak tipe dari akhiran nama file, dan .env bukan akhiran yang selalu dikenali. Nilai yang didukung: json, yaml, dotenv, ini, binary.
Perhatikan path_regex di langkah sebelumnya: secrets/.\.env(\.enc)?$ cocok untuk app.env maupun app.env.enc. Ini disengaja. Kalau regex-nya hanya secrets/.\.env$, file hasil enkripsi bernama app.env.enc tidak cocok lagi saat diedit, dan SOPS menolak karena tidak ada creation rule yang sesuai.
Tambahkan juga ke .gitignore supaya versi plaintext tidak pernah ikut ter-commit:
secrets/*.env
!secrets/*.env.enc
Langkah 5: Edit dan Jalankan Aplikasi Tanpa File Plaintext
Setelah terenkripsi, jangan pernah mengedit file itu dengan editor teks biasa. SOPS menyimpan MAC dari isi terenkripsi, dan satu perubahan manual di luar SOPS membuat dekripsi berikutnya gagal dengan MAC mismatch.
# buka di editor, simpan, otomatis dienkripsi ulang
sops edit secrets/app.env.enc
# cek status enkripsi
sops filestatus secrets/app.env.enc
--input-type/--output-type tetap bisa ditambahkan kalau SOPS salah menebak tipe. Untuk sekadar memeriksa isi, sops decrypt mencetak plaintext ke stdout, dan hasilnya ikut masuk scrollback terminal serta log sesi SSH.
Bagian yang membuat SOPS berguna di server adalah exec-env: file didekripsi, nilainya masuk sebagai environment variable, lalu perintah kita dijalankan.
sops exec-env secrets/app.env.enc 'docker compose up -d'
Nilai itu hanya masuk ke proses anak, tidak ke shell kita, dan tidak ada file plaintext yang ditulis ke disk. Docker Compose membaca variabel environment untuk interpolasi ${DB_PASSWORD}, jadi pola ini bekerja tanpa mengubah compose file. Kalau butuh isi file utuh, sops exec-file mendekripsi ke file sementara lalu menghapusnya setelah perintah selesai.
Untuk systemd, unit file-nya seperti ini:
[Service]
Environment=SOPS_AGE_KEY_FILE=/etc/sops/age/keys.txt
ExecStart=/usr/local/bin/sops exec-env /etc/app/secrets/app.env.enc '/usr/bin/node /srv/app/server.js'
Rotasi Kunci: updatekeys Dulu, rotate Kalau Perlu
Dua perintah ini mirip namanya tapi efeknya berbeda, dan tertukar adalah kesalahan umum. updatekeys menyinkronkan daftar penerima di file dengan isi .sops.yaml tanpa mengganti data key, cocok untuk menambah penerima baru. rotate membuat data key baru dan mengenkripsi ulang semua nilai, dipakai saat ada penerima yang harus dicabut:
sops updatekeys -y secrets/app.env.enc
sops rotate -i --rm-age age1lama... secrets/app.env.enc
Satu hal yang harus jujur diakui: menghapus penerima dari .sops.yaml tidak membuat commit lama jadi tidak terbaca. Commit lama masih bisa didekripsi kunci yang dulu dipakai, karena isinya sudah terenkripsi untuk kunci itu. Rotasi adalah soal ke depan, bukan pembersihan masa lalu.
Enam Jebakan yang Bikin Dekripsi Gagal
Semuanya berakhir dengan pesan error yang mirip, jadi daftar ini menghemat waktu:
- Kunci tidak ketemu di cron atau systemd.
HOMEberbeda dari shell interaktif. PakaiSOPS_AGE_KEY_FILEdengan path absolut. sopsdijalankan dari folder yang salah. Config dicari dari working directory. Jalankan dari root repo atau sebut--config.- Catch-all di urutan atas. Aturan umum yang menang di awal membuat aturan spesifik di bawahnya mati.
- MAC mismatch. File diedit dengan editor biasa. Ambil ulang dari git, lalu edit lewat
sops edit. exec-envmenolak struktur bertingkat. Nilai harus skalar dan nama variabel tidak boleh mengandung=. File.envaman; YAML bertingkat tidak.- Kunci privat ikut ter-commit. Kalau sudah terjadi, ganti kunci, enkripsi ulang, dan bersihkan riwayat dengan
git filter-reposebelum push ke remote mana pun.git rmsaja tidak cukup.
Verifikasi Sebelum Push
Sebelum commit pertama masuk remote, periksa lima hal:
git diffpada.env.enc: nilai berubah, nama variabel tetap terbaca.grep -c 'ENC\[' secrets/app.env.enc: jumlahnya sama dengan jumlah variabel sensitif.sops filestatus secrets/app.env.enc: file benar-benar terenkripsi.git log --all -- '*.env': tidak ada versi plaintext di riwayat mana pun.sops exec-envdi staging dengan perintah aplikasi yang sebenarnya, bukanecho.
Kesimpulan
SOPS memindahkan titik risiko ke tempat yang lebih bisa dikontrol: repo boleh berisi rahasia terenkripsi, dan kunci privat tinggal di mesin yang memang harus punya akses. Yang menentukan aman atau tidak adalah disiplin di dua hal, satu identitas per pihak dan rotasi kunci setiap kali ada yang keluar dari lingkaran.
Kalau baru pertama kali, mulai dari satu file .env dan satu layanan. Uji dulu alur edit, exec-env, dan rotasinya di staging, karena di situlah kesalahan konfigurasi paling sering muncul. Selamat mencoba, semoga repo-nya tetap rapi tanpa satu pun kunci yang bocor.

