Migrating from Kiln

Migrating from Kiln to TezBake

Kiln is being sunset. If you’re currently baking with Kiln, TezBake by Tez Capital is the recommended migration path. It’s a modern, actively maintained baking tool that manages your entire stack — node, baker, signer, DAL — under one CLI.

This guide walks you through the migration step by step.

TezBake runs on Linux and macOS (Ubuntu 22.04+, Debian 12+, or macOS with Apple Silicon / Intel). Linux is recommended for production bakers, but macOS is fully supported.

Prerequisites

• Linux or macOS machine — Ubuntu 22.04+, Debian 12+, or macOS (dedicated hardware recommended for production)
• Ledger — Nano S Plus or Nano X (the same one you used with Kiln)
• Your baker address — the tz1/tz2/tz3 address you’re currently baking with
• Root/sudo access on the machine

Hardware Minimums

Pre-Migration Checklist

Before touching anything, collect this information from your running Kiln setup:

• Baker address (tz1..., tz2..., or tz3...)
• Key type (ed25519/secp256k1/p256) and how it’s stored (Ledger, software wallet)
• Current cycle — check on TzKT or TzStats to confirm your baker is active
• Pending nonce revelations — if you have unrevealed nonces from the current cycle, wait for them to be revealed before migrating (or use a snapshot ≥5 days old during bootstrap)

⚠️ Never run two bakers with the same key at the same time. This causes double baking/attestation, which results in slashing (loss of funds). Always stop Kiln completely before starting TezBake.

Step-by-Step Migration

1. Note Your Baker Info

From your Kiln interface or config, record:

• Your baker’s tz address
• Whether you’re using a Ledger or software key
• Your Ledger derivation path (if applicable — typically ed25519/0h/0h)

2. Stop Kiln

Linux:

# If running as a systemd service
sudo systemctl stop kiln

# Or if using the Kiln CLI
kiln stop

macOS (if migrating to a separate Linux machine):

launchctl stop tezos.kiln

Confirm Kiln is fully stopped — no octez-node or octez-baker processes should be running:

ps aux | grep -E 'octez-node|octez-baker' | grep -v grep

This should return nothing.

3. Install TezBake

On your Linux machine:

wget -q https://github.com/tez-capital/tezbake/raw/main/install.sh -O /tmp/install.sh && sudo sh /tmp/install.sh

Verify installation:

tezbake version

4. Setup TezBake

Run the setup with DAL support (recommended for all bakers):

sudo tezbake setup --with-dal

This installs and configures:

• octez-node
• octez-baker
• octez-dal-node
• octez-signer (if using remote signer)

5. Configure Your Ledger

1. Connect your Ledger to the Linux machine via USB
2. Open the Tezos Baking app on the Ledger
3. Import your Ledger key:

sudo tezbake setup-ledger

Follow the prompts to select your key and derivation path, then authorize it for baking on the Ledger.

Note: You’ll need the Tezos Wallet app (not Baking) for one-time operations like registration. Switch back to the Tezos Baking app for ongoing baking.

Looking ahead: Once you’re stable on TezBake with your Ledger, we recommend migrating to a TezSign hardware signer with BLS/tz4 keys. TezSign is a purpose-built signing device (~$20–30 in hardware) that outperforms Ledger for baking and supports the tz4 key type required by modern protocol features like DAL companion keys. This is a separate migration you can plan after you’re settled on TezBake — see the TezSign documentation for details.

6. Bootstrap the Node

Rather than syncing from scratch, bootstrap from a snapshot:

sudo tezbake bootstrap-node https://snapshots.eu.tzinit.org/mainnet/rolling

Regional mirrors are available — replace eu with us or asia for faster downloads depending on your location.

Tip: If you have unrevealed nonces, use a snapshot that’s at least 5–6 days old to avoid nonce revelation issues.

Bootstrap takes anywhere from 10 minutes to an hour+ depending on your hardware and network speed.

7. Start Baking

sudo tezbake start

This starts the node, baker, DAL node, and signer as managed systemd services.

8. Register (If Needed)

If your baker has been inactive for more than 3 days, you may need to re-register:

sudo tezbake register-key

If your baker is already active and was only briefly offline during migration, registration is not required.

Ledger users: Registration requires the Tezos Wallet app. Switch back to Tezos Baking app after registration.

Post-Migration Verification

Run through each of these to confirm everything is working:

# Overall status
sudo tezbake info

# Signer status
sudo tezbake info --signer

# DAL status
sudo tezbake info --dal

# Node logs (watch for sync progress)
sudo tezbake node log -f

# Baker logs (watch for attestations/baking)
sudo tezbake node log baker -f

Checklist

• tezbake info shows node as synced
• tezbake info --signer shows signer connected and key loaded
• tezbake info --dal shows DAL node running
• Baker is producing attestations (check logs or TzKT)
• No missed slots in the first few cycles after migration
• Your baker appears active on tezos.systems

Troubleshooting

Node won’t sync

# Check node logs for errors
sudo tezbake node log -f

# If stuck, try re-bootstrapping
sudo tezbake stop
sudo tezbake bootstrap-node https://snapshots.us.tzinit.org/mainnet/rolling
sudo tezbake start

Ledger not connecting

• Ensure Ledger is unlocked and Tezos Baking app is open
• Check USB connection — try a different port or cable
• Make sure no other application (Ledger Live, etc.) is using the device
• Verify with sudo tezbake info --signer

Baker not producing attestations

• Confirm the node is fully synced first (tezbake info)
• Check that your baker key is properly imported
• Verify on TzKT that your baker has upcoming rights
• If recently migrated, rights may take 2+ cycles to appear

“Already baking” or double-baking warnings

• Immediately stop one of the bakers
• Confirm Kiln is completely stopped on all machines
• Never run the same key on two bakers simultaneously

DAL issues

# Check DAL profiles
sudo tezbake info --dal

# Update DAL profiles if needed
sudo tezbake update-dal-profiles --auto
sudo tezbake stop && sudo tezbake start

File Locations

TezBake stores everything under /bake-buddy/:

Useful Commands Reference

Further Resources

• Tez Capital Docs: docs.tez.capital
• TezPeak (monitoring dashboard): Included with TezBake — access via browser after setup
• TezPay (automated reward distribution): github.com/tez-capital/tezpay
• TezGov (governance & staking): gov.tez.capital
• Community Support: Tez Capital Discord
• Octez Documentation: octez.tezos.com