Other

TODO: Install without apt

Linux

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

• Installed Sia renterd software

• Created a renterd wallet

---

Pre-requisites

To ensure you will not run into any issues with running renterd it is recommended your system meets the following requirements:

• Network Access: renterd needs a stable internet connection and open network access in order to store and retrieve data on the Sia network.

• Operating System Compatibility: You must download the correct renterd binary for your version of Linux. If you are not sure which version you are on, you can run uname -m in a terminal to find out.

  • x86_64 — Linux AMD64

  • aarch64 — Linux ARM64

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

• Hardware Requirements: A stable setup that meets the following specifications is recommended. Not meeting these requirements may result in preventing slabs from uploading and can lead to a loss of data.

  • A Linux distro with systemd (Ubuntu, Debian, Fedora, Arch, etc)

  • A dual-core CPU

  • 16GB of RAM

  • An SSD with at least 128GB of free space.

  To ensure proper functionality, we are recommending 16GB RAM. This is because renterd will keep full slabs in memory when uploading. A full slab is 120MB, and a single upload may hold two or three slabs in memory. However, it is possible to run renterd with less RAM than this, and it may work fine depending on the use case.

---

Installing renterd

Open a Terminal using Crtl + Alt + T.

If you cannot open a Terminal using the above method, try one of the other methods listed here.

Once the Terminal loads, run one of the following commands to download and install the latest version of renterd to your /usr/local/bin directory.

Make sure to install the correct version for your system. If you are unsure which version you should pick, refer to the Pre-requisites section of this guide for instructions.

AMD64

wget https://sia.tech/downloads/latest/renterd_linux_amd64.zip &&\
unzip -j renterd_linux_amd64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_amd64.zip

ARM64

wget https://sia.tech/downloads/latest/renterd_linux_arm64.zip &&\
unzip -j renterd_linux_arm64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_arm64.zip

Zen AMD64

wget https://sia.tech/downloads/latest/renterd_zen_linux_amd64.zip &&\
unzip -j renterd_zen_linux_amd64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd_zen &&\
rm -fr renterd_zen_linux_amd64.zip

Zen ARM64

wget https://sia.tech/downloads/latest/renterd_zen_linux_arm64.zip &&\
unzip -j renterd_zen_linux_arm64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd_zen &&\
rm -fr renterd_zen_linux_arm64.zip

You’ll be prompted to authorize this action by providing your system password. You will not see anything when you type this in. Press Enter once you have entered your password.

---

Creating a wallet

renterd uses BIP-39 12-word recovery phrases. To generate a new wallet recovery phrase, run the following command:

Mainnet

renterd seed

Zen Testnet

renterd_zen seed

A new 12-word recovery phrase will be generated. Make sure to store it in a safe place, as you will need this phrase to recover your wallet.

---

Setting up a system user

Now that you have a recovery phrase, we will create a new system user and systemd service to run renterd securely on startup.

First, we will create a new system user with useradd and disable the creation of a home directory. This is a security precaution that will isolate renterd from any unauthorized access to our system. We will then use usermod to lock the account and prevent anyone from logging in under the account.

Mainnet

sudo useradd -M renterd &&\
sudo usermod -L renterd

Zen Testnet

sudo useradd -M renterd_zen &&\
sudo usermod -L renterd_zen

Now, we will create a new folder under /var/lib/ titled renterd and give it the appropriate permissions. This folder will be utilized specifically to store data related to the renterd software. Open the Terminal Emulator and run the following commands:

Mainnet

sudo mkdir /var/lib/renterd &&\
sudo chown renterd:renterd /var/lib/renterd &&\
sudo chmod o-rwx /var/lib/renterd

Zen Testnet

sudo mkdir /var/lib/renterd_zen &&\
sudo chown renterd_zen:renterd_zen /var/lib/renterd_zen &&\
sudo chmod o-rwx /var/lib/renterd_zen

---

Configure your renterd.yml file

To begin, create a file name renterd.yml file under /var/lib/renterd/

Mainnet

sudo nano /var/lib/renterd/renterd.yml

Zen Testnet

sudo nano /var/lib/renterd_zen/renterd.yml

Now, modify the file to add your wallet seed and API password. The recovery phrase is the 12-word phrase you generated in the previous step. Type it carefully, with one space between each word, or copy it from the previous step. The password is used to unlock the renterd web UI; it should be something secure and easy to remember.

your_access_key can be anywhere from 16 to 128 characters long, and your_private_key must be exactly 40 characters long.

seed: your seed phrase goes here
http:
  password: your_api_password
autopilot:
  heartbeat: 5m
s3:
  enabled: true
  disableAuth: false
  keypairsV4:
    your_access_key: your_private_key

Once you have added your recovery phrase and password, save the file with ctrl+s and exit with ctrl+x.

---

Setting up a systemd service

Now we can create a new system service to run renterd on startup:

Mainnet

sudo nano /etc/systemd/system/renterd.service

Zen Testnet

sudo nano /etc/systemd/system/renterd_zen.service

Once the editor loads, copy and paste the following into it.

Mainnet

[Unit]
Description=renterd
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/renterd
WorkingDirectory=/var/lib/renterd
Restart=always
RestartSec=15
User=renterd

[Install]
WantedBy=multi-user.target
Alias=renterd.service

Zen Testnet

[Unit]
Description=renterd (Zen Testnet)
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/renterd_zen
WorkingDirectory=/var/lib/renterd_zen
Restart=always
RestartSec=15
User=renterd_zen

[Install]
WantedBy=multi-user.target
Alias=renterd_zen.service

You can now save the file with ctrl+s and exit with ctrl+x.

---

Running renterd

Now it is time to start the service

Mainnet

sudo systemctl start renterd &&\
sudo systemctl enable renterd

Zen Testnet

sudo systemctl start renterd_zen &&\
sudo systemctl enable renterd_zen

On newer versions of Linux (Ubuntu 22.04+), sudo systemctl enable renterd may not be required as the service will automatically be enabled by default. If you get an error saying the service failed to be enabled due to the file already existing, it is okay to ignore it.

Your renterd service should now be running. You can check the status of the service by running the following command:

Mainnet

sudo systemctl status renterd

Zen Testnet

sudo systemctl status renterd_zen

If the service was set up correctly, it should say “active (running).”

If for some reason your renterd service will not start, use the command journalctl -fu renterd to view the console output for more information.

You can now access the Sia network using the renterd web UI by opening a browser and going to http://localhost:9980.

If you are running renterd on the Zen Testnet, you will need to access the web UI on port 9880 by going to http://localhost:9880.

Enter the API password you created in your renterd.yml to unlock the renterd web UI.

Congratulations, you have successfully set up renterd.

---

Updating

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

To update:

1. Stop the renterd system service.

Mainnet

sudo systemctl stop renterd

Zen Testnet

sudo systemctl stop renterd_zen

1. Download and install the latest version of renterd.

Make sure to install the correct version for your system. If you are unsure which version you should pick, refer to the Pre-requisites section of this guide for instructions.

AMD64

wget https://sia.tech/downloads/latest/renterd_linux_amd64.zip &&\
unzip -j renterd_linux_amd64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_amd64.zip

ARM64

wget https://sia.tech/downloads/latest/renterd_linux_arm64.zip &&\
unzip -j renterd_linux_arm64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_arm64.zip

Zen AMD64

wget https://sia.tech/downloads/latest/renterd_zen_linux_amd64.zip &&\
unzip -j renterd_zen_linux_amd64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd_zen &&\
rm -fr renterd_zen_linux_amd64.zip

Zen ARM64

wget https://sia.tech/downloads/latest/renterd_zen_linux_arm64.zip &&\
unzip -j renterd_zen_linux_arm64.zip renterd &&\
sudo mv renterd /usr/local/bin/renterd_zen &&\
rm -fr renterd_zen_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. Restart the renterd system service.

Mainnet

sudo systemctl start renterd

Zen Testnet

sudo systemctl start renterd_zen

1. Verify the renterd service is running correctly.

Mainnet

sudo systemctl status renterd

Zen Testnet

sudo systemctl status renterd_zen

If, for some reason, the renterd service will not start, use the command journalctl -fu renterd to view the console output for more information.

Starting renterd

Congratulations, you have successfully updated your version of renterd!