Comment on page
macOS
This guide will walk you through setting up
renterd on macOS. At the end of this guide, you should have:- Installed Sia
renterdsoftware - Created a
renterdwallet
- Network Access:
renterdinteracts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain. - Operating System Compatibility: Ensure your macOS version is compatible with the
renterdsoftware. Check releases supported by macOS versions. - System Updates: Ensure that your macOS is up to date with the latest system updates, as these updates can contain important security fixes and improvements.
Remember to check which version to download to ensure it works correctly with your operating system. To do this, click on the Apple icon in the top left corner of your toolbar, then click About This Mac. If the processor/chips says:
- Intel -
MacOS AMD64 - M1 or M2 -
MacOS ARM64
- 1.Download the latest version of
renterdyour operating system from the official website. For this guide, we'll be downloading the macOS version ofrenterd - 2.Now that we have downloaded
renterd, you may need to unzip it and move it to a more accessible location:- Double-click the downloaded
renterdzip file to unzip it if it hasn't done so automatically. - Click on the newly unzipped directory.
- Right-click on the path bar at the bottom of the Finder window and click Open in Terminal.
- 3.In the opened terminal window, move the
renterdbinary to/usr/local/binby running the following command and press enter:
sudo mv renterd /usr/local/bin
You'll be prompted to authorize this action by providing your system password. Type this in and press enter to continue.
- 4.Finally, for good practice, create a folder on the home drive. This folder will be utilized specifically to store data related to the
renterdsoftware.
mkdir ~/renterd
- 1.
renterduses BIP-39 12-word recovery phrases. If you already have a 12-word seed, skip this step; run the following command to generate a new wallet recovery phrase:
renterd seed
A new 12-word recovery phrase will be generated, so please copy and store it in a safe place, as you will need this phrase to recover your wallet.
If you lose this phrase, you will lose access to your wallet and funds. Find out more about Your Sia Seed and why it is essential.
Generating a recovery phrase
- 1.Run the following in your terminal command to start
renterd:
renterd
You will be prompted to input both:
API password- You choose this password, which can be anything you want. It will be used to unlock therenterdUI via your browser and should be something secure and easy to remember.wallet seed- 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.
These values are not stored anywhere and will be requested every time you start
renterd.You can also set the RENTERD
_SEED and RENTERD_API_PASSWORD environment variables so you do not have to re-enter the values every time.- 2.After entering your desired
API passwordand the createdseed,renterdwill start.
Starting renterd
- 3.You can now access the
renterdUI by opening a browser and going tohttp://localhost:9980.
Remember to leave the terminal window open while
renterd it is running. If you close the command prompt window, renterd stop.
renterd Login UI
Enter your
API password you created in the previous step to unlock renterd.Congratulations on successfully setting up
renterd and taking a significant step towards renting storage space on the Sia network.It is essential to keep your renter up to date. New versions of
renterd are released regularly and contain bug fixes and performance improvements.To update:
- 1.
- 2.Stop the
renterdservice withCmd+C. - 3.Unzip and replace
renterdwith the new version. - 4.Restart
renterd.
Last modified 1mo ago