macOS
Setup a new host on macOS
This guide will walk you through setting up a new hostd
node on macOS. For this guide, we are using a Macbook Pro M1, but the steps should work with any other macOS device. At the end of this guide, you should have a working hostd
node on the Sia network and be ready to accept contracts from renters.
Things you'll need
Below are the minimum requirements for hosting on Sia. If you do not meet these requirements you may not receive contracts from renters or risk losing Siacoins as a penalty. Hosting is a commitment that requires some technical knowledge and a stable setup.
A Mac that supports macOS 12 (Monterey) or 13 (Ventura)
A quad-core CPU
8GB of RAM
An SSD with at least 100GB of free space.
Additional storage space to rent out
A stable internet connection
hostd
supports Intel-based Macs and Apple-Silicon Macs, using the M1 and M2 processors.
This guide primarily uses the command line and assumes the user has sudo permissions.
Getting hostd
Download the latest version of hostd
for your operating system and platform from the official website: https://sia.tech/software/hostd.
For this guide, we will download the darwin/arm64
version and unzip the hostd
binary to /usr/local/bin
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-8d0895cc29a09e5539fd7912a13974c5235b2f97%252Fhostd_setup_mac_downloads.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=28203077&sv=1)
Now that we have downloaded hostd
we need to unzip it and move it to a more accessible location:
Double-click on the downloaded
hostd
zip file to unzip itClick on the newly unzipped directory
Right-click on the path at the bottom of the Finder window and click "Open in Terminal"
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-43a3050bd602699560fd939334fdb5fc028c530c%252Fhostd_setup_mac_open_terminal.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=9459f391&sv=1)
In the opened terminal window we will move the hostd
binary to /usr/local/bin
. Run the following command and press enter.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-61f0bba374a04ae067b46b6c4dafa1f472faa3b0%252Fhostd_setup_mac_mv.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=f6889821&sv=1)
Finally, we'll create a folder in our home drive to store hostd
's data. It is important to store hostd
's metadata on an SSD. You will need at least 80GB of space available. 50GB for the current blockchain and additional space for volume metadata.
Creating a wallet
hostd
uses BIP-39 12-word recovery phrases. It does not support legacy 28/29-word siad
seeds. If you already have a 12-word seed, skip this step. Run the following command to generate a new wallet recovery phrase:
After pressing enter, a new 12-word recovery phrase will be generated. Please write down this phrase and keep it in a safe place. You will need this phrase to recover your wallet. If you lose this phrase, you will lose access to your wallet and funds. You will also see the wallet's funding address. You can send Siacoin to this address to fund your host.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-29e65f6bf82166a0b6902ae7d7b1341137dbd845%252Fhostd_setup_mac_seed.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=3c4e5f02&sv=1)
Running hostd
In the same terminal you used to generate your recovery phrase, run the following command to start hostd:
You will be asked to input a password and a wallet recovery phrase. The password is used to unlock the hostd
UI, it should be something secure and easy to remember. 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; you will need to reenter them every time you start hostd
.
You can also set the HOSTD_SEED
and HOSTD_API_PASSWORD
environment variables so you do not have to reenter the values every time.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-19f1c4edb78ef757d578be932f3114f66d75a4bf%252Fhostd_setup_mac_run.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=36eb415c&sv=1)
After entering your password and recovery phrase, hostd
will start. You can now access the hostd
UI by opening a browser and going to http://localhost:9980
. Enter your password to unlock hostd
.
Send Siacoin to your wallet
Before you can start hosting, you must send Siacoin to your wallet. Hosts must lock Siacoin as collateral to ensure they are financially incentivized to store data. Hosts also need Siacoin to submit storage proofs to the blockchain. Therefore, it is essential to always keep your wallet funded with Siacoin. If your wallet runs out of Siacoin, your host cannot submit storage proofs and you will lose collateral.
To send Siacoin to your hostd
wallet, you must get the wallet's address which can be found on the "Wallet" page of the hostd
UI.
It is okay if your wallet is not synced at this point. You can still send funds to your wallet. However, they will not be available until the wallet is fully synced.
We recommend around $50 USD worth of Siacoin to start hosting. Hosts are constantly locking collateral; you may need more or less depending on how much data you store.
Navigate to the "Wallet" page by clicking the "Wallet" icon in the sidebar
Click the "Receive" button in the top right corner of the page
Copy your wallet address by clicking the "Copy" button or scan the QR code with your phone
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-d199a531c819751bca929bf00e7e91fefce8642e%252Fhostd_setup_mac_receive_addr.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=678e2d85&sv=1)
Add storage
A "volume" is a location on disk where hostd
will store uploaded data. A volume can be anywhere, including network drives and external drives. You can create multiple volumes to combine storage from multiple drives. To add a volume:
Click the "Volume" icon in the sidebar
Click the "Create Volume" button to add your first storage volume.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-220ff492ec92a1884c5d55fb184b642166240308%252Fhostd_setup_mac_create_volume.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=9ff16f00&sv=1)
Enter a name for the volume. We recommend something simple, like "hostdata.dat"
Use the built-in browser to select a folder to store the volume file.
Enter a maximum size for the volume. This is the maximum amount of data that can be stored in the volume.
Click "Create" to add the volume to `hostd`
After clicking "Create," the volume will be displayed in the volumes list. Depending on the size of the volume and the filesystem, it may take a while to fully provision the new volume. The progress will be displayed in the UI.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-d7b9948e81c9c2a73cd6f031c7cac65507642667%252Fhostd_setup_linux_volume_list.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=7f424ef7&sv=1)
Configure the host
Now that you have a volume, you can configure your host. First, navigate to the "Configuration" page in the sidebar. This page contains all of the pricing and settings available to hosts.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-6c82cf02e47963af39651030f631d8f9fa4fbabf%252Fhostd_setup_mac_volume_list.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=40a42d40&sv=1)
Accepting contracts
The first setting to configure is the "Accepting Contracts" setting. This setting determines whether your host will accept new contracts. Most hosts will always have this toggled on. However, if you want to exit the network you can toggle this off to stop accepting new contracts. You will still be required to fulfill any existing contracts before fully shutting down your host.
Address
The next setting to configure is your host's net address. This is the address that is published to the blockchain and used by renters to connect to your host. Some users use their public IP address, but we recommend setting up a domain. You can use a free service like DuckDNS or No-IP or purchase a custom domain from a registrar.
Whichever method you choose, enter your address in the "Net Address" field followed by your host's RHP2 port, which defaults to :9982
. For example, if your IP address is 199.111.78.80
you would enter 199.111.78.80:9982
. If your domain is example.com
, you would enter example.com:9982
.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-049cf4ac62a6fffb46418297ca8b327c586fb73a%252Fhostd_setup_windows_netaddress.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=721d364&sv=1)
Setup using Dynamic DNS
Setup using public IP
To find your public IP address click the following link: https://icanhazip.com. It will display your public IP address. Copy this address to your clipboard.
Pricing
On the Sia network, hosts set their prices for storage and bandwidth. The prices you select will determine how much you earn from hosting.
When setting prices, remember you are competing with other hosts. If your prices are too high, renters will choose other hosts. If your prices are too low, you will not earn enough to cover your costs.
We've put together some recommendations for pricing below. These are just recommendations, you can set your prices to whatever you want and change your prices at any time. Hosts will need to experiment with different prices to find the right balance between earnings and utilization.
Storage price: the amount of Siacoins you charge per TB per month of storage. We recommend around $1 USD per TB per month to start.
Collateral: the amount of Siacoins you lock per TB per month of storage. This should always be set to 2x your storage price. For example, if your storage price is 100 SC/TB/mo, you should set your collateral to 200 SC/TB/mo.
Ingress price: the amount of Siacoins you charge per TB of data uploaded to your host. We recommend setting this low to encourage renters to upload data. Between $0.00 and $0.05 USD per TB.
Egress price: the amount of Siacoins you charge per TB of data downloaded from your host. We recommend setting this higher to increase your earnings, above $5 USD per TB is a good starting point.
Maximum collateral: the maximum amount of Siacoins you will lock into a single contract for collateral. This setting is important to limit your risk per contract. A good starting point is However, if you refuse to lock enough collateral for the data a renter wants to store, they will choose another host. Therefore, we recommend setting this around 10x your collateral price. For example, if your collateral price is 200 SC/TB/mo, you should set your maximum collateral to 2000 SC/TB/mo.
We recommend leaving other settings, such as "Contract price", "Base RPC price", "Sector access price," and "Price table validity" at their default values. They are primarily for advanced users.
Once you are happy with your prices, click the "Save Changes" button in the top right corner of the page.
Port forwarding
If you have a firewall or router you will need to forward/open TCP ports 9981-9983. How to do so is outside of the scope of this guide, there are tutorials available for most routers/firewalls available on Google.
Waiting for sync
Now that you have configured your host, you must wait for your host to finish syncing the blockchain. This can take several hours or even days depending on your hardware and internet connection. You can check the progress of the sync by mousing over the "Sia" logo at the top of the sidebar.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-c5de121f0da784cf7db5ce53c72620f9753065f8%252Fhostd_setup_mac_sync.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=4bf016ac&sv=1)
Announce your host
Now that your host has finished syncing, you can announce your host to the network. This will publish your host's net address and public key to the blockchain so renters can connect to your host and form contracts. The announcement transaction costs a small amount of Siacoins, which will be deducted from your wallet.
To announce your host:
Click the "Configuration" icon in the sidebar
Click the "Announce" button in the top right corner of the page
Click "Announce" in the dialog to confirm
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-bb72cffe107118d1b43cb19bd30ece8a49ede085%252Fhostd_setup_mac_announce.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d9a7fa8c&sv=1)
After announcing, an "Unconfirmed" transaction will appear on the "Wallet" page. Once it is confirmed, your host will be visible on the network and renters will be able to form contracts with your host.
![](https://docs.sia.tech/~gitbook/image?url=https%3A%2F%2F1359353245-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FV2BVjqEgmmTvw2IQruD8%252Fuploads%252Fgit-blob-500903d94387c03ca988b381ddf15378cac89791%252Fhostd_setup_unconfirmed_transaction.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=43da9ce1&sv=1)
Check your host's status
Once the announcement is confirmed you can check if your host is visible on the network by going to https://troubleshoot.siacentral.com. Enter your host's net address and click "Check Host". This tool will connect to your host and notify you of any issues.
Updating
It is very important to keep your host up to date. New versions of hostd are released regularly and contain bug fixes and performance improvements.
To update:
Download the latest version of hostd from https://sia.tech/software/hostd
Stop the
hostd
service with the commandsudo systemctl stop hostd
Unzip and replace
hostd
in/usr/local/bin
with the new versionRestart
hostd
withsudo systemctl start hostd
Last updated