Linux

This guide will walk you through setting up walletd on Linux. At the end of this guide, you should have:

• Installed Sia walletd software

• Created a walletd wallet

Pre-requisites

To run walletd on Linux, your system should meet the following specifications:

• Operating System Compatibility: walletd is supported on the following Linux versions:

  • Trixie (Debian 13)

  • Bookworm (Debian 12)

  • Bullseye (Debian 11)

  • Plucky (Ubuntu 25.04)

  • Noble (Ubuntu 24.04)

  • Jammy (Ubuntu 22.04)

• Hardware Requirements: A stable setup that meets the following specifications is recommended.

  • A quad-core CPU

  • 8GB of RAM

  • 256 GB SSD for walletd

• System Updates: Ensure that your Linux system is up to date with the latest system updates, as these updates can contain important security fixes and improvements.

• Network Access: walletd interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.

Getting walletd

1. Download the latest version of walletd for your operating system from the official website. For this guide, we'll be downloading the Linux version of walletd .

2. Now that we have downloaded walletd, it's recommended to unzip the walletd binary to /usr/local/bin. Right-click the unzip file, select Open Terminal Here to open your Terminal Emulator, and run the following commands:

unzip walletd_linux_arm64.zip
sudo mv -t /usr/local/bin walletd
rm -rf walletd_linux_arm64.zip 

You'll be prompted to authorize this action by providing your system password. Type this in and press enter to continue.

1. Finally, for good practice, create a folder on the home drive. This folder will be utilized specifically to store data related to the walletd software. Open the Terminal Emulator and run the following command:

mkdir ~/walletd

Running walletd

1. Run the following in your Terminal Emulator to start walletd:

 walletd

You will be prompted to input a API password. You choose this password, which can be anything you want. It will be used to unlock the walletd UI, via your browser, should be something secure and easy to remember. This value is not stored anywhere; you will need to re-enter it every time you start walletd.

You can also set the WALLETD_API_PASSWORD environment variables so you do not have to re-enter the values every time.

1. After entering your desired API password, walletd will start.

2. You can now access the walletd UI by opening a browser and going to http://localhost:9980.

Remember to leave the Terminal Emulator open while walletd it is running. If you close the command prompt window, walletd stop.

Enter your API password you created in the previous step to unlock walletd.

Congratulations on successfully setting up walletd and taking a significant step towards storing data on the Sia network.

Updating

New versions of walletd are released regularly and contain bug fixes and performance improvements.

To update:

1. Download the latest version of walletd from the official website.

2. Stop the walletd service with Crtl+C.

3. Unzip and replace walletd with the new version.

4. Restart walletd.