> 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/mainet/celestia/upgrade.md).

# Upgrade

{% hint style="info" %}
**Network:** Celestia Mainnet Beta — chain-id `celestia`

**Current versions:** celestia-app / fibre `v10.5.0` · celestia-node `v0.34.3`

**Last updated:** October 30, 2026
{% endhint %}

{% hint style="warning" %}
`v10.5.0` is a minor, non-consensus-breaking update for nodes already on app version 10. It can be applied at any time. Always check [status.celestia.org](https://status.celestia.org) and the [release notes](https://github.com/celestiaorg/celestia-app/releases) before upgrading.
{% endhint %}

## Validator / consensus node (+ Fibre)

Build the new binaries **first**, then stop the services, so downtime is only the time it takes to swap binaries. Source builds require **Go 1.26.6+**.

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

```bash
APP_VERSION=v10.5.0

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

# multiplexer build of celestia-appd (do not use the standalone build or Cosmovisor)
make build
# Fibre server (validators)
make build-fibre-server

./build/celestia-appd version
./build/fibre version
```

{% hint style="info" %}
Prefer prebuilt binaries? Download `celestia-app_Linux_x86_64.tar.gz` and `fibre_Linux_x86_64.tar.gz` from the [v10.5.0 release](https://github.com/celestiaorg/celestia-app/releases/tag/v10.5.0) and verify them with `sha256sum --ignore-missing --check checksums.txt`.
{% endhint %}

### 2. Stop Fibre, then the node

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

If Fibre runs on a separate server, stop it there first.

### 3. Replace the binaries

```bash
sudo cp $HOME/celestia-app/build/celestia-appd $(which celestia-appd)
sudo cp $HOME/celestia-app/build/fibre /usr/local/bin/fibre

celestia-appd version
fibre version
```

On a separate Fibre server, build or download the `fibre` binary for the same release and replace it there.

### 4. Sync config

v10.5.0 adds a `[health]` table to Fibre's `server_config.toml`. Add it and any other missing settings (existing values are kept and a backup is created):

```bash
# set FIBRE_HOME to your Fibre home (e.g. /mnt/fibre-data/.celestia-fibre)
celestia-appd config sync --home $HOME/.celestia-app --fibre-home $FIBRE_HOME --dry-run
celestia-appd config sync --home $HOME/.celestia-app --fibre-home $FIBRE_HOME
```

On a separate Fibre server, run the same command there with only `--fibre-home`. `app.toml` is not touched by `config sync` — maintain it separately.

{% hint style="warning" %}
v10.5.0: Fibre object storage now **requires HTTPS**. If you use S3/R2 object storage, make sure the endpoint in `[object_storage]` is `https://`.
{% endhint %}

### 5. 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:

```bash
sudo systemctl start fibre
sudo journalctl -u fibre -f -o cat
```

### 6. Verify

```bash
# node is synced and on app version 10
celestia-appd status 2>&1 | jq .sync_info.catching_up
curl -s http://127.0.0.1:26657/abci_info | jq .result.response.app_version

# Fibre is still registered (found: true)
celestia-appd query valaddr provider $(celestia-appd comet show-address)

# Fibre readiness (from any machine)
grpc_health_probe -addr=<your-fibre-host>:7980 -tls -tls-no-verify
```

Restarting Fibre rotates its TLS certificate automatically — there is nothing to renew. You do **not** need to re-register the Fibre host after an upgrade.

### Still on v9 or older?

Mainnet activated app version 10 on Oct 20, 2026. A node on an older binary cannot follow the chain:

* Install the **multiplexer** build of `v10.5.0` (`make install` or the `celestia-app_Linux_x86_64.tar.gz` archive), not `celestia-app-standalone`, and do not use Cosmovisor.
* The OS must have glibc **2.38+** (Ubuntu 24.04). Ubuntu 22.04 fails with a glibc version error.
* Make sure `[grpc] enable = true` in `app.toml` and `priv_validator_grpc_laddr = "127.0.0.1:26669"` in `config.toml`, then run `config sync`.
* Validators must also set up Fibre — see the Fibre section on the [Installation page](/lucky-research-services/mainet/celestia/installation.md).

If the node halts with `wrong Block.Header.Version`, it was not upgraded in time: install the new binary and restart. If it still cannot sync, use `celestia-appd tendermint reset-state` (keeps `priv_validator_state.json`) and resync from a snapshot.

## Bridge node (celestia-node)

{% hint style="info" %}
celestia-node `v0.34.3` requires a core endpoint running celestia-app v10 and **Go 1.26.8+** for source builds.
{% endhint %}

Update Go if needed:

```bash
cd $HOME
ver="1.26.8"
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
```

Build first, then stop, swap and update config:

```bash
NODE_VERSION=v0.34.3
NODE_STORE=$HOME/.celestia-bridge   # 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

# merge newly added config fields, keeping your custom values
celestia bridge config-update --p2p.network celestia --node.store $NODE_STORE

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

Check the version and sync:

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

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