Updating Dojo

When a new version of Dojo is released, follow these steps to download, verify, then update to the latest version.

If you are unsure what Dojo version you are on, login to your DMT and displayed at the top will be the current version.

The following guide will update you to the latest Dojo version: 1.28.2

All commands are to be copy and pasted into the terminal of your Dojo, then press ENTER.

Upgrade system packages (optional)

Though this step is optional, it is recommended to first upgrade your system’s packages and dependencies to the latest versions. This helps to keep your system secure, and additionally can help prevent errors when updating Dojo to the latest version.

Fetch latest package versions
Terminal window
```
sudo apt-get update
```
Upgrade packages to latest version
Terminal window
```
sudo apt-get upgrade
```
Navigate to the Dojo script directory
Terminal window
```
cd ~/dojo-app/docker/my-dojo
```
Stop Dojo
Terminal window
```
./dojo.sh stop
```
Reboot your Linux system
Terminal window
```
sudo reboot
```

After your system has rebooted, log back in using your Dojo user credentials then continue to the next step in this guide.

Download required files

Download developer’s PGP key over Tor and import locally
Terminal window
```
torsocks wget https://keys.openpgp.org/vks/v1/by-fingerprint/E53AD419B242822F19E23C6D3033D463D6E544F6 && gpg --import E53AD419B242822F19E23C6D3033D463D6E544F6
```
Note: it is safe to run this command if you have already previously imported this public key when first installing Dojo.
Navigate to the Dojo script directory
Terminal window
```
cd ~/dojo-app/docker/my-dojo
```
Stop Dojo
Terminal window
```
./dojo.sh stop
```
Navigate to home directory
Terminal window
```
cd ~/
```

Download over Tor the latest version of Dojo from GitHub

torsocks wget -O samourai-dojo-1.28.2.zip https://github.com/Dojo-Open-Source-Project/samourai-dojo/archive/refs/tags/v1.28.2.zip

Download over Tor the Dojo fingerprints file and PGP signed fingerprints file from GitHub

torsocks wget https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases/download/v1.28.2/samourai-dojo-1.28.2-fingerprints.txt && torsocks wget https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases/download/v1.28.2/samourai-dojo-1.28.2-fingerprints.txt.sig

Verify the PGP signed fingerprints file:

gpg --verify samourai-dojo-1.28.2-fingerprints.txt.sig

✅ Successful result:

Successful verification is confirmed if the following is displayed on screen:

gpg: Signature made [date + time]
gpg: using EDDSA key E53AD419B242822F19E23C6D3033D463D6E544F6
gpg: Good signature from "dojocoder@pm.me" <dojocoder@pm.me> [unknown]
You can safely ignore the following if displayed:

gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
You may continue to the next step in this guide.

❌ Unsuccessful result:

If you observe a different result to the above, stop immediately. Do not continue following this guide. Do not update Dojo. Seek advice from a community member.

Verify SHA256 fingerprints

Verify the SHA256 fingerprints of the downloaded file:

sha256sum --check samourai-dojo-1.28.2-fingerprints.txt --ignore-missing

✅ Successful result

Successful verification is confirmed if the following is displayed on screen:

samourai-dojo-1.28.2.zip: OK

❌ Unsuccessful result

Unsuccessful verification might be displayed on screen:

samourai-dojo-1.28.2.zip: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match
sha256sum: samourai-dojo-1.28.2-fingerprints.txt: no file was verified

If the hashes do not match, stop immediately. Do not continue following this guide. Do not install Dojo. Seek advice from a community member.

Unpack files and upgrade Dojo

Unzip the downloaded file
Terminal window
```
unzip samourai-dojo-1.28.2.zip -d .
```
Copy the file contents into the Dojo directory
Terminal window
```
cp -a samourai-dojo-1.28.2/. dojo-app/
```

Remove the files which are no longer required

rm -r samourai-dojo-1.28.2 && rm samourai-dojo-1.28.2.zip && rm samourai-dojo-1.28.2-fingerprints.txt && rm samourai-dojo-1.28.2-fingerprints.txt.sig && rm E53AD419B242822F19E23C6D3033D463D6E544F6

Navigate to the Dojo script directory
Terminal window
```
cd ~/dojo-app/docker/my-dojo
```
Update Dojo to the latest version
Terminal window
```
./dojo.sh upgrade -y
```

Once you see a constant stream of “node.js”, “bitcoind”, and “fulcrum” logs, Dojo has updated successfully.

To exit the log screen, go: ctrl + c