---
title: Version Upgrade v0.2.1
slug: run-a-validator/version-upgrade-v021
description: Learn how to upgrade a previously installed and functioning validator in this comprehensive guide. Use the "xand" user without sudo privileges to follow the step-by-step process, including updating the repository, checking out a new version, and building 
docTags: 
createdAt: 2023-08-23T03:43:48.502Z
---

:::hint{type="warning"}
NOTE: Only use this guide to upgrade a validator that was installed and working using the previous `v0.1` or `v0.2` guide!
:::

:::hint{type="info"}
This process can be completed on a validator that is running but will require a restart after downloading and extracting new files.

Complete using `xand` user without `sudo` privledge.
:::

Download archive:

Change directory into home directory

Download new Release `tar.bz2` file from [https://github.com/Xandeum/binaries/releases](https://github.com/Xandeum/binaries/releases)

![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/qjrFssHfjWnUEp29sWjMf_image.png)

:::CodeblockTabs
CLI

```linux
wget https://github.com/Xandeum/binaries/releases/download/v0.2.1/xand-v0.2.1.tar.bz2
```
:::

Make your new directories

:::CodeblockTabs
CLI

```linux
mkdir ~/.local/share/xandeum/install/releases/v0.2.1/bin -p
```
:::

Extract the new release into the `bin` folder.

:::hint{type="warning"}
NOTE: Extracting can take a few minutes! 

Wait for the hostname/cursor to return to normal before proceding to the symlink operations!
:::

:::CodeblockTabs
CLI

```linux
cd ~
tar -xf xand-v0.2.1.tar.bz2 --directory ~/.local/share/xandeum/install/releases/v0.2.1/bin
```
:::

Remove old symlink

:::CodeblockTabs
CLI

```linux
rm /home/xand/.local/share/xandeum/install/releases/active_release
```
:::

Create symlink to new binaries

:::CodeblockTabs
CLI

```linux
ln -sf /home/xand/.local/share/xandeum/install/releases/v0.2.1/bin /home/xand/.local/share/xandeum/install/releases/active_release
```
:::

Test you have new version by verifying before you restart:

:::CodeblockTabs
CLI

```linux
xandeum-validator -V
```
:::

![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/baSQFkEBUG8Wn2_sdKQkh_image.png)

**Restart your validator when the delinquincy is below 10% to start using new version**

:::hint{type="info"}
NOTE: Using this exit command will check for cluster delinquincy, and check your validator for upcoming `leader slots` and will wait until you have a restart window to avoid missing block production! 

After it's clear of leader slots, and epoch isn't ending soon, a new snapshot will be taken, then the validator will shut down. 

**It will only restart on its own if you have the system service up and running!**

If you keep getting leader slots, you can try reducing `--min-idle-time` to zero and then the snapshot will still happen. The `-f` or `--force` flag can be added to skip checks for leader slots and epoch completion and it will not look for a suitable restart window or complete snapshotting. It will force the restart now.
:::

:::CodeblockTabs
CLI

```linux
xandeum-validator --ledger ~/ledger exit --max-delinquent-stake 10 --min-idle-time 4 --monitor
```
:::

:::hint{type="info"}
Below is showing waiting due to an upcoming leader slot
:::



![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/eCOTcWZtW1fofzv9GD_ou_image.png)

:::hint{type="info"}
Below is showing the validator has shut down. It is sitting idle until system service restarts the validator.
:::

![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/rlBe5yGJOzIE2RiKlCN0Z_image.png)

:::hint{type="info"}
Below is showing the validator is back running and syncing the ledger with the cluster.
:::

![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/aZrzQ9-ZToa1Bz9MXPfP3_image.png)

:::hint{type="info"}
Below is showing the validator is back running and validating with the tip of the cluster. This is normal and using `ctrl+c` will exit the monitor command. 

Upgrade is complete!
:::

![](https://api.archbee.com/api/optimize/ePevXmvzgG-7aqJ72Gpg_/EhlUAkX4EdQU85C-C89TR_image.png)