Skip to main content

Using a Wallet Server

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:

v1.26.0

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:

sudo apt-get update

Upgrade packages to latest version:

sudo apt-get upgrade
cd ~/dojo-app/docker/my-dojo

Stop Dojo:

./dojo.sh stop

Reboot your Linux system:

sudo reboot

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

Update Dojo

Download over Tor developer's PGP key, and import locally:

torsocks wget http://zkaan2xfbuxia2wpf7ofnkbz6r5zdbbvxbunvp5g2iebopbfc4iqmbad.onion/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.

cd ~/dojo-app/docker/my-dojo

Stop Dojo:

./dojo.sh stop
cd ~/

Download over Tor the latest version of Dojo from GitHub:

torsocks wget -O samourai-dojo-1.26.0.zip https://github.com/Dojo-Open-Source-Project/samourai-dojo/archive/refs/tags/v1.26.0.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.26.0/samourai-dojo-1.26.0-fingerprints.txt && torsocks wget https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases/download/v1.26.0/samourai-dojo-1.26.0-fingerprints.txt.sig

Verify the PGP signed fingerprints file:

gpg --verify samourai-dojo-1.26.0-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.

Continue copying and pasting the following commands in the terminal, then press ENTER.

Hash locally the downloaded Dojo .zip file using the SHA256 hash algorithm:

sha256sum samourai-dojo-1.26.0.zip

View the contents of the Dojo fingerprints file:

cat samourai-dojo-1.26.0-fingerprints.txt

Compare hashes:

Visually compare the SHA256 hash output carried out locally on the downloaded Dojo .zip file is an exact match of the hash stated in the Dojo fingerprints file.

✅ Successful result:

If these hashes are an exact match, you may continue to the next step in this guide.

Example:

You may continue to the next step in this guide.

❌ Unsuccessful result:

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

Continue copying and pasting the following commands in the terminal, then press ENTER.

Unzip the downloaded file:

unzip samourai-dojo-1.26.0.zip -d .

Copy the file contents into the Dojo directory:

cp -a samourai-dojo-1.26.0/. dojo-app/

Remove the files which are no longer required:

rm -r samourai-dojo-1.26.0 && rm samourai-dojo-1.26.0.zip && rm samourai-dojo-1.26.0-fingerprints.txt && rm samourai-dojo-1.26.0-fingerprints.txt.sig && rm E53AD419B242822F19E23C6D3033D463D6E544F6
cd ~/dojo-app/docker/my-dojo

Update Dojo to the latest version:

./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