Migrasi dari panduan asli berbasis zcashd. zcashd telah mencapai penghentian otomatis Akhir-Dukungan pada 18 Juli 2026, sehingga panduan ini sekarang menggunakan Zebra (full node saat ini, yang dikelola oleh Zcash Foundation) dan Zallet (dompet yang dibuat untuk menggantikan dompet bawaan zcashd).
Versi sebelumnya dari panduan ini menjelaskan cara melakukan kompilasi zcashd secara native pada Pi 4 — sebuah proses kompilasi single-threaded yang memakan waktu 3–4 jam karena Pi 4 tidak memiliki memori yang cukup untuk build paralel (-j$(nproc)). Zebra dan Zallet sekarang keduanya menyediakan binari ARM64 dan Docker image resmi yang sudah jadi, sehingga dalam kebanyakan kasus kamu tidak perlu lagi mengompilasi apa pun dari source pada Pi itu sendiri.
Biner siap pakai dan Docker image milik Zebra dan Zallet memerlukan glibc 2.34+, yang berarti kamu membutuhkan Ubuntu Server 22.04 atau yang lebih baru (64-bit/aarch64).
ssh <username>@<pi-hostname-or-ip>lsblk/mnt/zcash-data, dengan pengaturan mkfs/fstab standar agar dapat auto-mount saat reboot.sudo apt update && sudo apt full-upgrade -y
sudo reboot
sudo apt install -y docker.io
sudo usermod -aG docker $USER # log out/in after this
docker run -d \
--name zebra \
-p 8233:8233 \
-v /mnt/zcash-data/zebra:/home/zebra/.cache/zebra \
zfnd/zebra:latest
Periksa progres: docker logs -f zebra
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
cargo install cargo-binstall
cargo binstall zebrad
zebrad start
Ini menginstal biner aarch64 yang sudah jadi — tidak perlu melakukan kompilasi.
Mengenai waktu sinkronisasi: harap maklum jika ini memakan waktu lama — angka sinkronisasi pertama yang sering dikutip (sekitar 2 jam) berasal dari perangkat keras referensi yang lebih kuat daripada CPU Pi 4, jadi waktu sinkronisasi aktual kamu pada perangkat keras Pi 4 yang sebenarnya kemungkinan akan berjalan lebih lama.
Zallet saat ini masih dalam tahap alpha — harap antisipasi adanya perubahan yang dapat merusak sistem, dan jangan menganggapnya sebagai solusi kustodial siap pakai untuk dana dalam jumlah besar.
docker pull zodlinc/zallet:latest
Gambar ini mendukung ARM64 (melalui build berbasis Nix) dan berjalan dari filesystem minimal tanpa shell — berikan konfigurasi dan jalur data secara eksplisit melalui --datadir dan mount volume (lihat Langkah 6).
# Requires Rust 1.85+ (see Step 4B for rustup install)
sudo apt install -y clang libclang-dev protobuf-compiler
cargo install --locked --git https://github.com/zcash/wallet.git
Crate milik Zallet belum dipublikasikan ke crates.io selama fase alpha, jadi menginstal langsung dari repo git adalah metode non-Docker yang didukung.
Buat zallet.toml di datadir pilihanmu (misalnya /mnt/zcash-data/zallet):
[builder.limits]
[consensus]
network = "main"
[database]
[external]
[features]
as_of_version = "0.0.0"
[features.deprecated]
[features.experimental]
[indexer]
validator_address = "127.0.0.1:8232" # Zebra's JSON-RPC endpoint
[keystore]
[note_management]
[rpc]
bind = ["127.0.0.1:SOMEPORT"]
Sesuaikan validator_address jika Zebra berjalan pada host/port yang berbeda, dan konfigurasi validator_cookie_auth/validator_user/validator_password di bawah [indexer] agar sesuai dengan pengaturan autentikasi RPC Zebra kamu.
Beralih dari zcashd? Jika kamu masih memiliki zcash.conf lama:
zallet migrate-zcash-conf --datadir /path/to/old/zcashd/datadir -o /mnt/zcash-data/zallet/zallet.toml
Zallet mengenkripsi semua materi kunci menggunakan age/rage:
cargo install rage
rage -p -o /mnt/zcash-data/zallet/encryption-identity.txt <(rage-keygen)
Ini mencetak kunci publik dan passphrase yang dibuat secara otomatis — simpan passphrase tersebut; kamu tidak dapat memulihkan file identitas tanpanya.
zallet -d /mnt/zcash-data/zallet init-wallet-encryption
zallet -d /mnt/zcash-data/zallet generate-mnemonic
Hanya jalankan generate-mnemonic satu kali kecuali jika kamu sengaja menginginkan beberapa root spending yang independen.
zallet -d /mnt/zcash-data/zallet start
zallet -d /mnt/zcash-data/zallet migrate-zcashd-wallet --zcashd-datadir /path/to/old/zcashd/datadir
Ini memerlukan utilitas db_dump (dibangun menggunakan Berkeley DB 6.2.23) — dari instalasi sistem atau hasil build-sumber lokal dari zcashd. Jika kamu tidak lagi memiliki zcashd yang terinstal, ini adalah satu langkah migrasi yang belum sepenuhnya mandiri di dalam Zallet.
zallet -d /mnt/zcash-data/zallet help
Pastikan dompet merespons, dan setelah Zebra selesai melakukan sinkronisasi, pastikan saldo/alamat sudah sesuai dengan ekspektasi.
docker, atau gunakan sudo untuk sementara waktu.zodlinc/zallet dirancang dari nol (from-scratch) — selalu masukkan --datadir secara eksplisit dan mount direktori data kamu sebagai volume.Zebra dan Zallet umumnya lebih ringan pada CPU selama pengaturan dibandingkan saat mengompilasi zcashd, karena kamu menjalankan biner/container yang sudah jadi. RAM 4 GB adalah titik awal yang wajar; pantau dengan htop dan pertimbangkan varian Pi 4 8 GB jika kamu melihat swapping yang berat.