> For the complete documentation index, see [llms.txt](https://services.luckyresearch.org/lucky-research-services/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://services.luckyresearch.org/lucky-research-services/testnet/celestia/upgrade.md).

# Upgrade

{% hint style="info" %}
**Network:** Celestia Mocha testnet — chain-id `mocha-5`

**Current versions:** celestia-app / fibre `v10.6.0-mocha` · celestia-node `v0.34.4-mocha`

**Last updated:** November 7, 2026
{% endhint %}

{% hint style="success" %}
**v10.6.0-mocha** is a minor update for nodes already on app version 10 — no coordinated upgrade, no config changes since v10.5.0. Validators should upgrade promptly: it ships celestia-core v0.42.8 (consensus, p2p, mempool and RPC fixes) plus Fibre and Hyperlane fixes.
{% endhint %}

{% hint style="warning" %}
Still running **mocha-4**? It has been shut down and cannot be upgraded in place. `mocha-5` is a new chain — set it up in a fresh home following the [Installation page](/lucky-research-services/testnet/celestia/installation.md).
{% endhint %}

## Validator / consensus node (+ Fibre)

### 1. Update Go (required: 1.26.10)

```bash
go version   # skip this block if it already shows go1.26.10 or newer

cd $HOME
ver="1.26.10"
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"
go version
```

### 2. Build the new binaries (node keeps running)

`make install` builds the **multiplexer** and writes it to `$HOME/go/bin`. The running node is not affected until it restarts.

```bash
APP_VERSION=v10.6.0-mocha

cd $HOME
rm -rf celestia-app
git clone https://github.com/celestiaorg/celestia-app.git
cd celestia-app
git checkout tags/$APP_VERSION

make install
make build-fibre-server

$HOME/go/bin/celestia-appd version
./build/fibre version
```

{% hint style="info" %}
If your service runs `celestia-appd` from a path other than `$HOME/go/bin`, copy `$HOME/go/bin/celestia-appd` there in step 4. Prebuilt binaries: [v10.6.0-mocha release](https://github.com/celestiaorg/celestia-app/releases/tag/v10.6.0-mocha) (verify against `checksums.txt`).
{% endhint %}

### 3. Stop Fibre, then the node

```bash
sudo systemctl stop fibre
sudo systemctl stop celestia-appd
```

### 4. Replace the Fibre binary

```bash
sudo cp $HOME/celestia-app/build/fibre /usr/local/bin/fibre

celestia-appd version   # should report v10.6.0-mocha
fibre version
```

### 5. Check config (optional)

No new settings since v10.5.0. Running `config sync` only confirms nothing is missing:

```bash
celestia-appd config sync --home $HOME/.celestia-app --fibre-home $FIBRE_HOME --dry-run
```

If you are upgrading from **v10.4.0-mocha or older**, run it without `--dry-run` to add Fibre's `[health]` table. Fibre object storage requires an `https://` endpoint.

### 6. Start the node, then Fibre

```bash
sudo systemctl start celestia-appd
sudo journalctl -u celestia-appd -f -o cat

# once the node is signing again
sudo systemctl start fibre
sudo journalctl -u fibre -f -o cat
```

### 7. Verify

```bash
celestia-appd status 2>&1 | jq .sync_info.catching_up
celestia-appd query valaddr provider $(celestia-appd comet show-address)
grpc_health_probe -addr=<your-fibre-host>:7980 -tls -tls-no-verify
```

If the node uses a custom home or ports, add `--home` / `--node` to the commands above. You do not need to re-register the Fibre host.

## Bridge node (celestia-node)

Build with the same Go version (1.26.10 covers celestia-node's requirement).

```bash
NODE_VERSION=v0.34.4-mocha
NODE_STORE=$HOME/.celestia-bridge-mocha-5   # change to your bridge store path

cd $HOME
rm -rf celestia-node
git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node
git checkout tags/$NODE_VERSION
make build
./build/celestia version

sudo systemctl stop celestia-bridge
sudo make install

celestia bridge config-update --p2p.network mocha --node.store $NODE_STORE

sudo systemctl restart celestia-bridge && sudo journalctl -u celestia-bridge -f -o cat
```

Check:

```bash
celestia version
celestia header sync-state --node.store $NODE_STORE
```

Release notes: [celestia-app v10.6.0-mocha](https://github.com/celestiaorg/celestia-app/releases/tag/v10.6.0-mocha) · [celestia-node v0.34.4-mocha](https://github.com/celestiaorg/celestia-node/releases/tag/v0.34.4-mocha)