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

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

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

torsocks wget http://zkaan2xfbuxia2wpf7ofnkbz6r5zdbbvxbunvp5g2iebopbfc4iqmbad.onion/vks/v1/by-fingerprint/82820715CECC657E81914847E2520B7E41F39962 && gpg --import 82820715CECC657E81914847E2520B7E41F39962

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

Verify the PGP signed fingerprints file:

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

✅ Successful result:

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

  • gpg: Signature made [date + time]
    gpg: using RSA key 82820715CECC657E81914847E2520B7E41F39962
    gpg: Good signature from "    pajasevi@samourai.is" [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 v1.25.0.zip

View the contents of the Dojo fingerprints file:

cat samourai-dojo-1.25.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 v1.25.0.zip -d .

Copy the file contents into the Dojo directory:

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

Remove the files which are no longer required:

rm -r samourai-dojo-1.25.0 && rm v1.25.0.zip && rm samourai-dojo-1.25.0-fingerprints.txt && rm samourai-dojo-1.25.0-fingerprints.txt.sig && rm 82820715CECC657E81914847E2520B7E41F39962
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