Tutorial Litestream SQLite: Replikasi Real-Time ke Cloudflare R2 di VPS

Bayangkan ponsel Anda berdering pukul dua malam. Pesan peringatan muncul dari sistem: server VPS tempat aplikasi Anda berjalan mendadak mati total akibat kerusakan hardware pada penyedia cloud. Anda bergegas mengecek sistem, lalu sadar bahwa skrip backup bawaan hanya berjalan otomatis sekali sehari pada tengah malam. Artinya, seluruh transaksi pengguna, pendaftaran akun baru, dan perubahan data dari jam 12 malam sampai jam 2 pagi hilang tanpa sisa.

Bagi banyak pengembang perangkat lunak, skenario buruk ini menjadi alasan utama mereka enggan menggunakan SQLite di lingkungan produksi. SQLite kerap dicap sebagai basis data kelas mainan yang hanya cocok untuk aplikasi seluler, pengujian lokal, atau proyek sampingan. Kekhawatiran terbesar selalu tertuju pada risiko kehilangan data ketika server tunggal mengalami kegagalan total.

Padahal dari sisi performa, SQLite menawarkan kecepatan baca dan tulis lokal yang luar biasa. Karena berjalan di dalam proses aplikasi yang sama, tidak ada hambatan latensi jaringan (IPC overhead) seperti yang sering dijumpai pada PostgreSQL atau MySQL. Aplikasi dapat merespons permintaan pengguna jauh lebih cepat dengan konsumsi sumber daya CPU dan RAM yang sangat hemat.

Kabar baiknya, Anda tidak perlu lagi mengorbankan keamanan data demi mengejar kecepatan tersebut. Panduan ini akan membahas langkah demi langkah mengonfigurasi Litestream untuk mereplikasi basis data SQLite secara real-time ke Cloudflare R2, layanan penyimpanan objek kompatibel S3 tanpa biaya transfer data keluar (egress fee).

1. Mengapa Backup SQLite Cara Lama Berbahaya & Bagaimana WAL Litestream Bekerja

Sebelum masuk ke teknis konfigurasi, mari kita bedah dahulu mengapa metode pencadangan konvensional pada SQLite sering kali gagal melindungi data secara optimal.

Secara umum, pengembang biasanya menggunakan tiga cara lama untuk mencadangkan SQLite:

• Menyalin file .db langsung secara manual saat aplikasi berjalan.
• Menggunakan perintah CLI bawaan .backup.
• Menjalankan skrip cronjob berkala yang mengompresi file basis data.

Ketiga pendekatan di atas memiliki kelemahan mendasar. Jika Anda menyalin file .db yang sedang aktif menerima proses penulisan data, berkas hasil salinan berisiko tinggi mengalami kerusakan struktur (corrupt data). Sementara itu, metode pencadangan berkala via cronjob menciptakan celah kerentanan yang disebut Recovery Point Objective (RPO). Apabila cronjob disetel berjalan setiap 6 jam sekali, Anda harus siap kehilangan data transaksi selama 6 jam terakhir ketika server mendadak tumbang.

Bagaimana Litestream Menyelesaikan Masalah Ini?

Basis data SQLite modern memanfaatkan fitur bernama Write-Ahead Logging (WAL). Saat aplikasi menambah, mengubah, atau menghapus baris data, SQLite tidak langsung memperbarui file utama (app.db). Informasi perubahan tersebut dicatat terlebih dahulu ke dalam file pembantu bernama WAL (app.db-wal).

Di sinilah Litestream berperan. Litestream beroperasi sebagai program latar belakang (daemon) yang sangat ringan. Tugas utamanya adalah memantau berkas WAL tersebut secara terus-menerus. Setiap kali ada perubahan halaman data baru di dalam berkas WAL, Litestream akan langsung mengunggah potongan perubahan tersebut ke penyimpanan cloud dalam hitungan milidetik.

Bayangkan SQLite seperti seorang kasir toko yang mencatat setiap transaksi penjualan ke dalam buku catatan harian (file WAL). Litestream adalah asisten sibuk yang berdiri di samping kasir. Begitu kasir selesai menulis satu baris transaksi, asisten tersebut langsung memfoto lembaran tersebut dan mengirimkannya ke gudang penyimpanan aman di cloud pada detik yang sama.

Dengan mekanisme ini, Anda mendapatkan beberapa keuntungan utama:

• RPO Mendekati Nol: Data berhasil diamankan ke cloud hampir seketika saat transaksi aplikasi diselesaikan (commit).
• Performa Aplikasi Tetap Cepat: Aplikasi backend Anda tetap membaca dan menulis ke penyimpanan lokal VPS yang super cepat tanpa terganggu latensi jaringan cloud.
• Hemat Biaya Operasional: Penggunaan Cloudflare R2 membuat biaya operasional sangat rendah karena tidak ada biaya tambahan untuk transfer data keluar (zero egress fee).

2. Panduan Setup Litestream, Cloudflare R2 & Systemd Daemon

Mari kita mulai praktik pemasangan dari awal. Panduan ini mengasumsikan Anda menggunakan server VPS berkonfigurasi Linux (seperti Ubuntu atau Debian) dan telah memiliki akun Cloudflare.

Langkah A: Mempersiapkan Cloudflare R2

1. Masuk ke dasbor Cloudflare Anda, lalu buka menu R2 Object Storage dari panel sebelah kiri.
2. Buat bucket baru dan berikan nama yang mudah dikenali, misalnya sqlite-backup-production.
3. Pada halaman utama R2, klik menu Manage R2 API Tokens di sebelah kanan.
4. Pilih opsi Create API Token, kemudian atur hak akses menjadi Edit (dapat membaca dan menulis objek).
5. Simpan tiga informasi penting yang muncul di layar: Access Key ID, Secret Access Key, dan Endpoint URL (dengan format standar https://<account_id>.r2.cloudflarestorage.com).

Langkah B: Memasang Litestream di Server VPS

Buka terminal VPS Anda dan jalankan perintah berikut untuk mengunduh serta menginstal berkas biner Litestream terbaru:

wget https://github.com/benbjohnson/litestream/releases/download/v0.3.13/litestream-v0.3.13-linux-amd64.tar.gz
tar -xzf litestream-v0.3.13-linux-amd64.tar.gz
sudo mv litestream /usr/local/bin/

Setelah proses pemindahan selesai, pastikan pemasangan berhasil dengan memeriksa versi yang terinstall:

litestream version

Langkah C: Membuat Berkas Konfigurasi Litestream

Selanjutnya, buat berkas konfigurasi YAML di lokasi /etc/litestream.yml. Berkas ini berfungsi memberi tahu Litestream mengenai lokasi file basis data lokal dan tujuan replikasinya.

access-key-id: "YOUR_R2_ACCESS_KEY_ID"
secret-access-key: "YOUR_R2_SECRET_ACCESS_KEY"

dbs:
  - path: /var/www/myapp/data/production.db
    replicas:
      - url: s3://sqlite-backup-production/production.db
        endpoint: https://<account_id>.r2.cloudflarestorage.com
        sync-interval: 1s
        retention: 72h

Pastikan Anda mengganti /var/www/myapp/data/production.db sesuai dengan lokasi aktual berkas basis data aplikasi Anda. Parameter retention: 72h secara otomatis akan menghapus rekam jejak dan snapshot lama yang sudah melebihi batas waktu 3 hari agar penyimpanan cloud Anda tidak membengkak.

Langkah D: Menjalankan Litestream sebagai Daemon Systemd

Agar proses replikasi berjalan otomatis di latar belakang dan kembali aktif secara mandiri jika server melakukan boot ulang, kita perlu membuat layanan systemd.

Buat file baru di /etc/systemd/system/litestream.service dengan isi berikut:

[Unit]
Description=Litestream Continuous Replication
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/litestream replicate -config /etc/litestream.yml
Restart=on-failure
RestartSec=5
User=root

[Install]
WantedBy=multi-user.target

Aktifkan dan jalankan layanan tersebut dengan mengetikkan perintah:

sudo systemctl daemon-reload
sudo systemctl enable litestream
sudo systemctl start litestream

Periksa status layanan untuk memastikan proses replikasi berjalan tanpa kendala:

sudo systemctl status litestream

3. Simulasi Disaster Recovery: Restore Data & Handling Lock

Strategi pemulihan bencana tidak dapat dipercaya sebelum disimulasikan secara nyata. Mari kita uji dua skenario penyelamatan data untuk membuktikan ketangguhan sistem ini.

Skenario 1: Pemulihan Basis Data Total (Full Restore)

Bayangkan VPS lama Anda rusak total dan Anda harus menyiapkan server baru dari nol. Setelah memasang Litestream dan menyalin berkas /etc/litestream.yml di server baru, Anda hanya perlu menjalankan satu perintah untuk mengunduh seluruh data terbaru dari Cloudflare R2:

litestream restore \
  -config /etc/litestream.yml \
  -o /var/www/myapp/data/production.db \
  s3://sqlite-backup-production/production.db

Litestream akan mengonstruksi ulang berkas production.db hingga ke titik transaksi terakhir sebelum server lama mengalami gangguan.

Skenario 2: Pemulihan Titik Waktu Spasial (Point-in-Time Recovery / PITR)

Bagaimana jika terjadi kecelakaan akibat kesalahan manusia, misalnya seorang pengembang secara tidak sengaja menghapus tabel utama pada pukul 14:30? Jika Anda memulihkan data ke kondisi paling akhir, tabel yang terhapus tersebut akan tetap hilang.

Fitur Point-in-Time Recovery (PITR) pada Litestream memungkinkan Anda mengembalikan kondisi basis data ke beberapa menit sebelum perintah berbahaya tersebut dieksekusi:

litestream restore \
  -config /etc/litestream.yml \
  -timestamp "2026-03-30T14:29:00Z" \
  -o /var/www/myapp/data/restored_production.db \
  s3://sqlite-backup-production/production.db

Dengan perintah di atas, basis data dipulihkan tepat pada posisi pukul 14:29:00, sehingga data yang terhapus pada pukul 14:30 dapat diselamatkan kembali.

Penanganan Database Lock dan Optimalisasi Mode WAL

Agar aplikasi backend dan Litestream dapat beroperasi secara simultan tanpa memunculkan kendala penguncian berkas (database is locked), pastikan aplikasi Anda mengeksekusi perintah PRAGMA berikut saat memulai koneksi ke SQLite:

PRAGMA journal_mode = WAL;
PRAGMA busy_timeout = 5000;
PRAGMA synchronous = NORMAL;

Penjelasan singkat kegunaannya:

• PRAGMA journal_mode = WAL: Mengaktifkan mode catatan WAL agar operasi membaca dan menulis dapat dilakukan bersamaan tanpa saling mengunci.
• PRAGMA busy_timeout = 5000: Memberikan toleransi waktu tunggu selama 5 detik bagi proses tulis ketika basis data sedang sibuk, mencegah aplikasi melempar kesalahan transaksi gagal.
• PRAGMA synchronous = NORMAL: Mengoptimalkan kecepatan penulisan disk tanpa mengorbankan integritas data saat terjadi kegagalan daya.

4. Monitoring & Langkah Praktis Selanjutnya

Menjalankan sistem replikasi secara otomatis bukan berarti Anda dapat mengabaikannya begitu saja. Lakukan pemantauan berkala untuk memastikan proses sinkronisasi tetap berjalan lancar.

Tips Memantau Kesehatan Litestream:

• Cek Generasi Replika: Jalankan perintah litestream generations /var/www/myapp/data/production.db secara berkala untuk memastikan offset log terus bertambah secara aktif.
• Pantau Log Layanan: Periksa adanya gangguan koneksi jaringan menggunakan perintah journalctl -u litestream -f.
• Uji Pemulihan Otomatis: Buat skrip terjadwal sederhana untuk mengunduh dan memverifikasi integritas hasil pemulihan ke direktori sementara seminggu sekali.

Mengombinasikan SQLite dengan Litestream dan Cloudflare R2 memberikan keunggulan terbaik dari dua dunia: performa akses lokal yang sangat cepat dengan jaminan keamanan data tingkat tinggi.

Langkah terbaik yang bisa Anda ambil sekarang adalah memasang Litestream pada aplikasi berbasis SQLite di lingkungan uji coba atau produksi Anda hari ini. Buat kredensial Cloudflare R2, aktifkan layanan daemon-nya, dan coba jalankan simulasi pemulihan data sekali. Setelah merasakan kemudahannya, Anda dapat menjalankan aplikasi produksi menggunakan SQLite dengan tenang dan percaya diri.