Belajar Restic - Inisialisasi Repository

#Pendahuluan

Di episode 2 kalian memahami arsitektur tiga pilar: repository, snapshot, dan chunking. Sekarang saatnya membangun pilar pertama — repository sungguhan. Inisialisasi adalah langkah yang hanya dilakukan sekali, tapi kesalahan di sini (terutama soal password) berbuah bencana jangka panjang.

Prinsip yang harus diingat: restic init membuat struktur repository dan kunci enkripsi yang dilindungi password. Setelah ini, password adalah segalanya.

#Persiapan Environment Variable

Sebelum semua perintah restic, biasakan meng-export dua variabel agar perintah tidak perlu mengulang flag:

export RESTIC_REPOSITORY=/backup/restic
export RESTIC_PASSWORD='h4sH-yang-sangat-Panjang-dan-Unik'

RESTIC_REPOSITORY menggantikan -r, dan RESTIC_PASSWORD menghindari prompt interaktif — wajib saat dipakai di cron atau systemd (episode 9).

#Init Repository Lokal

Inisialisasi backend lokal cukup satu perintah:

restic init --repo /backup/restic

Output sukses

created restic repository 2223e26e6b at /backup/restic
 
Please note that knowledge of your password is required to access
the repository. Losing your password means that your data is
irrecoverably lost.

Tanpa RESTIC_PASSWORD, restic akan meminta password dua kali. Catatan di output bukan basa-basi — lupa password = data hilang permanen, bahkan restic sendiri tidak punya backdoor.

#Init Repository S3

Untuk backend S3-compatible (MinIO, AWS S3, GCS, Azure), tujuannya URL bucket:

export AWS_ACCESS_KEY_ID=minioadmin
export AWS_SECRET_ACCESS_KEY=minioadmin
restic init -r s3:https://minio.example.com/backup-bucket

Bucket harus sudah ada; restic tidak membuatkannya otomatis. Untuk S3 publik seperti AWS, pakai endpoint regional:

restic init -r s3:s3.ap-southeast-1.amazonaws.com/backup-bucket

Perbedaan backend dan contoh konfigurasinya dibahas lengkap di episode 7.

#Menggunakan --repository-file

Alih-alih menulis URL di tiap command atau env, simpan di file (misal /etc/restic/repo):

restic --repository-file /etc/restic/repo init

Isi file cukup satu baris: URL repository. Ini memudahkan konfigurasi terpusat dan pemisahan repository antar script.

#Mengelola Password dengan Aman

Password repository adalah kunci seluruh data. Beberapa pola penyimpanan dari yang paling sederhana sampai enterprise:

#1. Environment Variable

export RESTIC_PASSWORD="$(cat /etc/restic/passphrase)"

#2. GPG-encrypted file

gpg -c /etc/restic/passphrase
export RESTIC_PASSWORD_FILE=/etc/restic/passphrase.gpg

RESTIC_PASSWORD_FILE membuat restic mendekripsi file berisi password dengan gpg pada setiap pemakaian.

#3. Secret Manager

Untuk production, simpan di Vault/OpenBao, AWS Secrets Manager, atau password manager, lalu injeksi sebagai environment saat proses backup berjalan.

#Kesalahan Umum Saat Init

• Init di direktori tidak kosong: restic menolak dengan repository master key and config already initialized atau error serupa. Selalu pakai direktori/bucket kosong khusus repository.
• Password salah konfigurasi: prompt muncul padahal sudah ada RESTIC_PASSWORD — biasanya karena variabel tidak di-export atau typo nama.
• Bucket S3 belum ada: init gagal dengan repository master key and config already initialized hanya jika terulang; error awal biasanya AccessDenied atau NoSuchBucket — buat bucket dulu.
• Lupa password: tidak ada recovery. Simpan salinan cadangan password di lokasi terpisah dari repository.

#Penutup

• restic init membuat repository + kunci enkripsi yang dilindungi password.
• Gunakan RESTIC_REPOSITORY dan RESTIC_PASSWORD untuk menghindari prompt berulang.
• Backend S3: restic -r s3:... init, pastikan bucket sudah dibuat.
• --repository-file memisahkan konfigurasi repo dari command.
• Simpan password di env, gpg, atau secret manager — jangan di git.
• Lupa password = data hilang permanen. Tidak ada jalan pintas.

Di episode 4 selanjutnya kita menjalankan backup pertama & snapshot — membackup direktori dengan tag dan exclude, lalu membaca hasilnya lewat restic snapshots, restic stats, dan restic ls. Repository kalian akan mulai hidup.