diff --git a/.gitbook/assets/indexd-screenshots/indexd-ui.png b/.gitbook/assets/indexd-screenshots/indexd-ui.png
new file mode 100644
index 00000000..e26cd868
Binary files /dev/null and b/.gitbook/assets/indexd-screenshots/indexd-ui.png differ
diff --git a/.gitbook/assets/indexd-screenshots/install/docker/01-indexd-docker-pull.png b/.gitbook/assets/indexd-screenshots/install/docker/01-indexd-docker-pull.png
new file mode 100644
index 00000000..25591d38
Binary files /dev/null and b/.gitbook/assets/indexd-screenshots/install/docker/01-indexd-docker-pull.png differ
diff --git a/.gitbook/assets/indexd-screenshots/install/docker/02-indexd-docker-config.png b/.gitbook/assets/indexd-screenshots/install/docker/02-indexd-docker-config.png
new file mode 100644
index 00000000..393cdb90
Binary files /dev/null and b/.gitbook/assets/indexd-screenshots/install/docker/02-indexd-docker-config.png differ
diff --git a/.gitbook/assets/indexd-screenshots/install/docker/03-indexd-docker-started.png b/.gitbook/assets/indexd-screenshots/install/docker/03-indexd-docker-started.png
new file mode 100644
index 00000000..60f08566
Binary files /dev/null and b/.gitbook/assets/indexd-screenshots/install/docker/03-indexd-docker-started.png differ
diff --git a/.gitbook/assets/sia-storage-screenshots/01-sia-storage-signup.png b/.gitbook/assets/sia-storage-screenshots/01-sia-storage-signup.png
new file mode 100644
index 00000000..3bcb007b
Binary files /dev/null and b/.gitbook/assets/sia-storage-screenshots/01-sia-storage-signup.png differ
diff --git a/.gitbook/assets/sia-storage-screenshots/02-sia-storage-app-signin.png b/.gitbook/assets/sia-storage-screenshots/02-sia-storage-app-signin.png
new file mode 100644
index 00000000..0b068897
Binary files /dev/null and b/.gitbook/assets/sia-storage-screenshots/02-sia-storage-app-signin.png differ
diff --git a/.gitbook/assets/sia-storage-screenshots/03-sia-storage-app-connect.png b/.gitbook/assets/sia-storage-screenshots/03-sia-storage-app-connect.png
new file mode 100644
index 00000000..1c0fa33c
Binary files /dev/null and b/.gitbook/assets/sia-storage-screenshots/03-sia-storage-app-connect.png differ
diff --git a/.gitbook/assets/sia-storage-screenshots/04-sia-storage-app-files.png b/.gitbook/assets/sia-storage-screenshots/04-sia-storage-app-files.png
new file mode 100644
index 00000000..be1f89a6
Binary files /dev/null and b/.gitbook/assets/sia-storage-screenshots/04-sia-storage-app-files.png differ
diff --git a/README.md b/README.md
index 4bc43525..9bd0b963 100644
--- a/README.md
+++ b/README.md
@@ -17,17 +17,23 @@ layout:
visible: true
---
-Sia is the world's safest cloud storage, by design—a purely decentralized peer-to-peer network with **no central access point**, **no gatekeepers**, and **no insanely expensive hardware requirements**. It offers a radically new level of **privacy**, **security**, **performance** and **pricing** — all through a unique **nonprofit model**.
+Sia is decentralized, peer-to-peer cloud storage with no central provider and no gatekeepers. Files are encrypted on your own device before upload, so no storage provider can read your data, and you hold the keys. The network is developed by a non-profit and runs on open-source software.
-So whether you’re a developer looking to build on an open-source and decentralized cloud platform, or a user ready to take control of your data, you’re in the right place!
+Whether you're a developer building on Sia or a user storing your own data, these docs cover how to use the network.
-Our documentation is your comprehensive guide and single source of truth for learning how to interact with the Sia Network.
+# Where to start
+
+* **Store your data** — the simplest way to start is the [Sia Storage app with a free Sia Storage account](renting/using-sia-storage.md) (50 GB). For how it works, see [About Storing Your Data](renting/about-renting.md).
+* **Provide storage and earn Siacoin** — set up [`hostd`](hosting/about-hosting-on-sia.md).
+* **Hold and manage Siacoin** — use [`walletd`](wallet/wallet-overview.md).
+* **Build an application on Sia** — see the [Sia Developer Portal](https://devs.sia.storage).
+* **Not sure which software you need?** — [Which Sia software do I need?](get-started-with-sia/sia-software-overview.md)
# Get Involved
## Contribute to Docs
-Keeping our docs up to date is important, and we welcome community contributions—whether suggesting edits or adding new articles.
+We welcome community contributions to the docs—whether suggesting edits or adding new articles.
1. To submit edits via GitHub, click dropdown in the top-right corner and select **Edit on GitHub**. You’ll be taken directly to the corresponding page on GitHub.
@@ -49,23 +55,23 @@ You can toggle the **Preview** button to see how the markdown will be formatted.
4. Once you're satisfied, click **Commit Changes** to submit your edits.
{% hint style="success" %}
-Congratulations! You’ve successfully submitted your edits via GitHub. Your edits will be reviewed by The Sia Foundation.
+You’ve submitted your edits via GitHub. Your edits will be reviewed by The Sia Foundation.
{% endhint %}
## Contribute to Sia
-Our core team of engineers at The Sia Foundation believes that principles are everything—in **Systems Creativity**, **Technical Integrity**, and **Personal Agency**. As a 100% open-source project, we've had countless individuals contribute to the core code and to apps built on top of the network. These contributions **invest in and strengthen the Sia cloud storage network, engage the Sia community, and educate the public about the urgency of data privacy and ownership**.
+Our core team of engineers at The Sia Foundation works according to three principles: **Systems Creativity**, **Technical Integrity**, and **Personal Agency**. As a fully open-source project, we've had many individuals contribute to the core code and to apps built on top of the network.
-Check out our [GitHub](https://github.com/SiaFoundation) to follow along or contribute code to help further our mission.
+Check out our [GitHub](https://github.com/SiaFoundation) to follow along or contribute code.
## Join our Community
-Join our [Discord](https://discord.com/invite/sia)—a hub for developers, users, and anyone curious about decentralized cloud storage, privacy, and security. It’s the place for support, collaboration, and updates. Want to contribute? Head to `#contributors` to say hi, ask questions, or share your Sia-related code or app.
+Join our [Discord](https://discord.com/invite/sia) for developers, users, and anyone curious about decentralized cloud storage, privacy, and security. It's where you can find support and updates. Want to contribute? Head to `#contributors` to say hi, ask questions, or share your Sia-related code or app.
{% hint style="info" %}
**Need Assistance?**
-Join the `#help` channel on our [Discord](https://discord.com/invite/sia), where the community is always ready to help.
+Join the `#help` channel on our [Discord](https://discord.com/invite/sia), where the community can help.
You can also [email us](mailto:hello@sia.tech), and we’ll get back to you as soon as possible.
{% endhint %}
diff --git a/SUMMARY.md b/SUMMARY.md
index bac20fdb..ad066312 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -6,13 +6,18 @@
## Get Started with Sia
* [Learn about Sia](get-started-with-sia/sia101.md)
+* [Which Sia software do I need?](get-started-with-sia/sia-software-overview.md)
* [Learn about Siacoins](get-started-with-sia/learn-about-siacoins.md)
* [Your Sia Seed](get-started-with-sia/the-importance-of-your-seed.md)
## Store Your Data
* [About Storing Data on Sia](renting/about-renting.md)
-* [Installing renterd](renting/setting-up-renterd/README.md)
+* [Using Sia Storage](renting/using-sia-storage.md)
+* [Setting up indexd](renting/setting-up-indexd/README.md)
+ * [Docker](renting/setting-up-indexd/docker.md)
+ * [Transferring Siacoins](renting/transferring-siacoins.md)
+* [Setting up renterd](renting/setting-up-renterd/README.md)
* [macOS](renting/setting-up-renterd/macos.md)
* [Linux](renting/setting-up-renterd/linux/README.md)
* [Debian](renting/setting-up-renterd/linux/debian.md)
@@ -20,14 +25,18 @@
* [Other](renting/setting-up-renterd/linux/other.md)
* [Docker](renting/setting-up-renterd/docker.md)
* [Windows](renting/setting-up-renterd/windows.md)
-* [Transferring Siacoins](renting/transferring-siacoins.md)
-* [Storing Your Data](renting/renting-storage/README.md)
+ * [Storing Your Data](renting/renting-storage/README.md)
* [Managing Your Files](renting/renting-storage/managing-your-files.md)
+## Build on Sia
+
+* [Sia Developer Portal](https://devs.sia.storage)
+* [SDK Quickstart](https://devs.sia.storage/docs/quickstart)
+
## Provide Storage
* [About Providing Storage on Sia](hosting/about-hosting-on-sia.md)
-* [Installing hostd](hosting/setting-up-hostd/README.md)
+* [Setting up hostd](hosting/setting-up-hostd/README.md)
* [Linux](hosting/setting-up-hostd/linux/README.md)
* [Debian](hosting/setting-up-hostd/linux/debian.md)
* [Ubuntu](hosting/setting-up-hostd/linux/ubuntu.md)
@@ -59,7 +68,6 @@
## Integrations
* [Sia Ledger app with Sia Central](sia-integrations/using-the-sia-ledger-nano-app-sia-central.md)
-* [Sia Ledger Nano app with CLI](sia-integrations/using-the-sia-ledger-nano-app-cli.md)
* [S3 Integrations](sia-integrations/s3-integrations/README.md)
* [Jellyfin](sia-integrations/s3-integrations/jellyfin.md)
* [Nextcloud](sia-integrations/s3-integrations/nextcloud.md)
@@ -70,9 +78,5 @@
* [V2: The Final Cut - Network Upgrade (December 2025)](miscellaneous/sias-december-2025-hardfork-ecosystem-status.md)
* [V2 Hardfork - June 2025](v2/README.md)
* [How to Upgrade: Exchanges](v2/exchanges.md)
- * [Sia Ecosystem Fork Status](navigating-the-v2-hardfork/sia-ecosystem-fork-compliance.md)
* [Siacoin Total Supply](miscellaneous/siacoin-total-supply.md)
-* [Siafunds](/siafunds/learn-about-siafunds.md)
- * [Withdrawing Siafunds](siafunds/how-to-cash-out-siafunds.md)
- * [SEC Settlement](siafunds/sec-settlement-faq.md)
* [Brand Guidelines](miscellaneous/sia-brand-guidelines.md)
diff --git a/get-started-with-sia/learn-about-siacoins.md b/get-started-with-sia/learn-about-siacoins.md
index 4890d941..46539b05 100644
--- a/get-started-with-sia/learn-about-siacoins.md
+++ b/get-started-with-sia/learn-about-siacoins.md
@@ -14,15 +14,15 @@ layout:
# Learn about Siacoins
-## Siacoins: The Power Behind Sia Network
+## Siacoins on the Sia Network
-Siacoins (SC) are the utility tokens powering the Sia network and are essential for any activity on the network. Siacoins serve a singular purpose – facilitating network operations – yet are utilized in various ways, such as:
+Siacoins (SC) are the utility tokens used on the Sia network and are required for any activity on the network. Siacoins serve a single purpose – facilitating network operations – and are used in various ways, such as:
* Uploading files to Sia, you use Siacoins to pay for storage.
* Earning Siacoins for storing others' data.
* Transferring by sending them to others or receiving them at your wallet address.
-Siacoins can be securely stored using our [official software](https://sia.tech/software/walletd) on a hardware or paper wallet. Initially, obtaining Siacoins is simple: having someone send them to you, purchasing them on an exchange, or engaging in mining activities.
+Siacoins can be stored using our [official software](https://sia.tech/software/walletd) on a hardware or paper wallet. You can obtain Siacoins by having someone send them to you, purchasing them on an exchange, or mining.
## How to obtain Siacoins
@@ -30,7 +30,7 @@ Whether you want to upload files to the decentralized cloud or lend extra storag
### Buy from an exchange
-Siacoins are listed on several prominent exchanges, and you can access the complete list of exchanges where Siacoins are available on our [official website](https://sia.tech/community?category=exchanges). Purchasing Siacoins from an exchange typically offers competitive prices but may involve a relatively steep learning curve for new users.
+Siacoins are listed on several exchanges, and you can find the list of exchanges where Siacoins are available on our [official website](https://sia.tech/community?category=exchanges). Purchasing Siacoins from an exchange typically offers competitive prices but may involve a steep learning curve for new users.
{% hint style="info" %}
Some exchanges support direct fiat (local currency) to Siacoin purchases, but others require you to buy Bitcoins, Ethereum, or other cryptos to make your purchase. Please visit the exchange's official website to find out more.
@@ -53,7 +53,7 @@ You can also receive Siacoins, share your QR code for others to scan, and send f
### Mining on the network
\
-When you mine on a cryptocurrency network, you contribute computing power to help process and verify transactions. Miners are the backbone of the network, verifying the integrity of the blockchain. On Sia, miners are rewarded with Siacoins for their services.
+When you mine on a cryptocurrency network, you contribute computing power to help process and verify transactions. Miners verify the integrity of the blockchain. On Sia, miners are rewarded with Siacoins for their services.
Our [official website](https://sia.tech/community-ecosystem?software=mining\_pools) shows a list of Siacoins mining pools. Please see their documentation to get started.
@@ -61,7 +61,7 @@ Our [official website](https://sia.tech/community-ecosystem?software=mining\_poo
The block reward is the miner's incentive to contribute their computing power and electricity costs to the network. When a block is successfully verified or solved, an amount of Siacoins is paid out to those who mined the block.
-Unlike Bitcoin and other cryptocurrency blockchains, the Sia block reward never stops and gives infinite rewards. This means miners will always be incentivized to be part of Sia. Once the block reward reaches 30,000 coins, it stays there forever.
+Unlike Bitcoin and other cryptocurrency blockchains, the Sia block reward does not stop decreasing to zero. Once the block reward reaches 30,000 coins, it stays at that level, so miners continue to receive a reward for each block.
{% hint style="info" %}
When the Sia network launched, the block reward was 300,000 Siacoins. This decreases by one every block, with a floor at 30,000 – reached at block 270,000 (300,000 - block height).
@@ -69,7 +69,7 @@ When the Sia network launched, the block reward was 300,000 Siacoins. This decre
#### Proof-of-work
-The Sia blockchain operates on Proof-of-Work, ensuring the integrity of transactions and contracts. Whether used for power cryptocurrencies like Bitcoin or utility and smart storage contracts like Sia, trust is inherent in a blockchain's immutability. With no central authority to oversee transactions or contract validity, the assurance comes from the blockchain itself. Proof-of-Work serves as a robust safeguard, deterring any attempts to alter the history of the blockchain through significant effort and expense.
+The Sia blockchain operates on Proof-of-Work to maintain the integrity of transactions and contracts. Whether used to power cryptocurrencies like Bitcoin or utility and storage contracts like Sia, trust comes from a blockchain's immutability. With no central authority to oversee transactions or contract validity, the assurance comes from the blockchain itself. Proof-of-Work deters attempts to alter the history of the blockchain by making it require significant effort and expense.
diff --git a/get-started-with-sia/sia-software-overview.md b/get-started-with-sia/sia-software-overview.md
new file mode 100644
index 00000000..18663e85
--- /dev/null
+++ b/get-started-with-sia/sia-software-overview.md
@@ -0,0 +1,64 @@
+---
+description: A side-by-side guide to the Sia software and the terms used across these docs.
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Which Sia software do I need?
+
+There are several pieces of Sia software, each for a different job. Use this page to find the one that matches what you want to do.
+
+| I want to… | Use |
+|------------|-----|
+| Store and manage files the easy way | The **Sia Storage app** (desktop, mobile) with a [Sia Storage](https://sia.storage) account — 50 GB free |
+| Use Sia through an S3-compatible API | [`s3d`](https://github.com/SiaFoundation/s3d), connected to an indexer such as Sia Storage |
+| Build my own app | The [Sia Storage SDKs](https://devs.sia.storage) |
+| Run the indexer myself instead of using Sia Storage | [`indexd`](../renting/setting-up-indexd/) — requires PostgreSQL |
+| Provide storage and earn Siacoin | [`hostd`](../hosting/about-hosting-on-sia.md) |
+| Hold and manage Siacoin | [`walletd`](../wallet/wallet-overview.md) |
+| Run the older all-in-one renter | [`renterd`](../renting/setting-up-renterd/) — no longer the preferred way to store data |
+
+## How the pieces fit together
+
+To store data on Sia you run a **client** that connects to an **indexer**. The client encrypts your files and moves them to and from storage providers; the indexer manages contracts and keeps your data healthy. By itself, an indexer like Sia Storage doesn't store your files — you need a client to use it. See [About Storing Your Data](../renting/about-renting.md) for more.
+
+### Clients — how you use Sia storage
+
+* **Sia Storage app** — desktop and mobile apps for storing and retrieving files. Point it at an indexer; a Sia Storage account is the easiest option.
+* **`s3d`** — a lightweight, S3-compatible gateway. It translates the AWS S3 API to Sia and connects to an indexer such as Sia Storage, so existing S3 tools and applications can use Sia storage.
+* **Sia Storage SDKs** — client libraries (Rust, Go, Python, JavaScript) for building your own app. The Sia Storage app and `s3d` are currently the only ready-made clients.
+
+### Indexer — the backend
+
+* **Sia Storage** — a hosted indexer. It manages contracts and keeps your data healthy for you, with 50 GB free and nothing to run. Recommended for most people.
+* **`indexd`** — the indexer software, for running the backend yourself instead of using Sia Storage. Requires PostgreSQL.
+
+### Other software
+
+* **`hostd`** — storage-provider software. Stores encrypted data for the network and earns Siacoin.
+* **`walletd`** — a standalone wallet for Siacoin and Siafunds, with Ledger support.
+* **`renterd`** — the original all-in-one renter (wallet, contracts, and an upload/download UI in one program). Still works, but no longer the preferred way to store data.
+
+## Glossary
+
+* **Renter** — anyone storing data on Sia. The renter forms and pays for storage contracts; today an indexer fills this role on your behalf.
+* **Storage provider (host)** — an operator running `hostd` that stores encrypted data and earns Siacoin.
+* **Client** — software you run to store and retrieve files, such as the Sia Storage app or `s3d`. A client connects to an indexer.
+* **Indexer** — the backend that manages contracts, tracks where data lives, and keeps it healthy. Sia Storage is a hosted indexer; `indexd` is the software for running your own.
+* **Contract** — a blockchain-enforced agreement between a renter and a storage provider covering how much data to store, for how long, and at what price.
+* **Object** — the application-level view of a stored file: its data, metadata, and storage layout under a single content-derived ID.
+* **Slab** — a unit of an object's data that is erasure-coded into shards.
+* **Shard** — one erasure-coded, encrypted piece of a slab, stored by a single provider.
+* **Erasure coding** — a method of splitting data into redundant pieces so the original can be rebuilt from a subset of them.
+* **Siacoin (SC)** — the network's utility token, used to pay for storage.
+* **Siafund** — a separate token that receives a fee from storage contracts.
+* **Recovery phrase (seed)** — the secret words that control a wallet and let you recover it.
diff --git a/get-started-with-sia/sia101.md b/get-started-with-sia/sia101.md
index 68ee6483..d7bdfbb1 100644
--- a/get-started-with-sia/sia101.md
+++ b/get-started-with-sia/sia101.md
@@ -14,60 +14,60 @@ layout:
# Learn about Sia
-The Sia Foundation is a non-profit organization committed to advancing and enhancing the Sia decentralized storage network. Our vision revolves around a future where individuals entirely own their data. This future is devoid of walled gardens, vendor lock-in, or the risk of a single provider accessing your information or holding your files hostage. Sia paves the way for this future by establishing a trustless marketplace where peers can buy and sell cloud storage directly.
+The Sia Foundation is a non-profit that develops the Sia decentralized storage network. Sia lets you store data directly with operators around the world instead of with a single company, so no one provider can read your files, lock you in, or take your data offline.
-Sia is a decentralized cloud storage platform secured by blockchain technology. The Sia storage network leverages underutilized hard drive capacity worldwide to create a data storage marketplace that is more reliable and cheaper than traditional cloud storage providers. Sia has its blockchain and a utility token that powers it – the Siacoin (SC).
+Sia is decentralized cloud storage secured by a blockchain. It uses spare hard-drive capacity from operators worldwide to create a storage marketplace that is typically cheaper than traditional cloud providers. The network has its own blockchain and a utility token, Siacoin (SC), used to pay for storage.
-Privacy, high performance, and robust engineering principles are at the heart of Sia's philosophy. Our primary objective is to bring the power of decentralization to data storage. We aim to empower you with complete, exclusive control over your data, ensuring it remains safeguarded against theft, censorship, and unwarranted access. With Sia, your data truly belongs to you, and our documentation is here to guide you in harnessing the capabilities of our software suite.
+Your files are encrypted on your own device before they're uploaded, so storage providers only ever hold encrypted pieces and can't read your data. Because you hold the keys, you control who can access your files.
## Genesis of Sia
-Sia was conceived at HackMIT in 2013 by David Vorick and Luke Champine. The founders formed Nebulous Labs and later Skynet Labs to develop Sia. The Sia Foundation was created as a non-profit dedicated to leading core development into the future of decentralized storage.
+Sia was created at HackMIT in 2013 by David Vorick and Luke Champine. The founders formed Nebulous Labs, later Skynet Labs, to develop Sia. The Sia Foundation is a non-profit dedicated to the network's core development.
-## ELI5: Understanding how Sia works
+## How Sia works
-When a file is uploaded to Sia, it undergoes a process of sharding, encryption, and global distribution. Renters are responsible for uploading files, while storage providers store these files, and the entire operation is automated. After uploading your files, the network guarantees continuous accessibility by creating multiple copies. Furthermore, storage providers are never granted access to these files as they only receive encrypted shards of the complete files.
+When you upload a file to Sia, it's encrypted on your machine, split into redundant pieces using [erasure coding](https://devs.sia.storage/docs/core-concepts/erasure-coding), and distributed across many independent storage providers. Providers only receive encrypted pieces, never your whole file, so they can't read your data. Only a subset of the pieces is needed to reconstruct a file, so your data stays available even if some providers go offline.
-Your data remains genuinely private and is distributed across the globe, eliminating any single point of failure and guaranteeing the utmost uptime reliability. As you hold the encryption keys, you retain full ownership of your data. No external entity can access or exert control over your files.
+Because the pieces are spread across unrelated providers and you hold the encryption keys, there is no single provider that can read your files, hand over readable copies, or take your data offline.
-Data cannot be subject to de-platforming, and your files are impervious to hacking attempts.
+### Storing data on Sia
-### **Storing Data on Sia**
+When you store data on Sia you act as a *renter*: you form contracts with storage providers that set how much data to store, for how long, and at what price. This contract management is handled for you by [Sia Storage](https://sia.storage) (a hosted service) or by running your own [indexer](../renting/setting-up-indexd/). See [About Storing Your Data](../renting/about-renting.md) for how the pieces fit together.
-Uploading files to Sia automatically designates you as a renter within the network. As a renter, you can upload your files to storage providers—other users who have allocated their storage capacity.
+### Providing storage on Sia
-The term 'renter' is employed because Sia initiates contracts with these storage providers. These contracts specify the quantity of data to be stored, the duration of storage, and the associated cost.
+Providing storage means contributing spare storage capacity to the network. In return for storing data and periodically proving you still hold it, you earn Siacoin (SC), which you can use to pay for your own storage or exchange for other currencies. See [About Providing Storage](../hosting/about-hosting-on-sia.md).
-### Providing Storage on Sia
+## Sia software
-Providing storage on Sia signifies your commitment to providing surplus storage capacity to the network. By doing so, you actively contribute to the core principle of safeguarding data in the hands of its rightful owners—the renters.
+The Sia Foundation maintains an open-source software suite for using and operating the network. Which one you need depends on what you want to do — see [Which Sia software do I need?](sia-software-overview.md) for a side-by-side breakdown.
-In return for your providing your storage, you earn Siacoin, the cryptocurrency fueling the Sia network. Siacoin can be utilized to acquire your own storage space or exchange for other cryptocurrencies or fiat currencies on various crypto exchanges.
+To store data on Sia you run a *client* (an app) that connects to an *indexer* (the backend). The client encrypts your files and moves them to and from storage providers; the indexer manages contracts and keeps your data healthy.
-Storage providers play a pivotal role within the ecosystem, serving as indispensable contributors to the decentralized network that forms the heart of Sia.
+### Sia Storage
-## Core software
+[Sia Storage](https://sia.storage) is a hosted indexer — it manages contracts and keeps your data healthy for you, with 50 GB free and nothing to run. On its own it's just the backend; you use it through a client such as the Sia Storage app or `s3d`. For most people, the Sia Storage app with a Sia Storage account is the easiest way to start.
-The Sia Foundation has developed a scalable, high-performing, easy-to-integrate software suite.
+### Sia Storage app and s3d
-### renterd
+These are the clients you use to actually store and retrieve files. The **Sia Storage app** runs on desktop and mobile. **`s3d`** is an S3-compatible gateway that lets existing S3 tools and applications use Sia. Both connect to an indexer — Sia Storage by default — and you can also build your own client with the [Sia Storage SDKs](https://devs.sia.storage).
-`renterd` aims to serve the needs of everyday users -- who want a simple interface for storing and retrieving their data -- and developers -- who want a powerful, flexible, and reliable API for building apps on Sia.
+### indexd
-### hostd
+`indexd` is the indexer software, for running the backend yourself instead of using Sia Storage. It forms and renews storage contracts with providers, tracks where your data lives, and repairs it in the background. Clients and applications connect to it to store and retrieve data without managing providers themselves.
-`hostd` is designed to enhance the experience for storage providers within the Sia network. Tailored for individual and large-scale storage providers, `hostd` boasts a user-friendly interface and a robust API, empowering providers to manage their storage resources and revenue efficiently.
+### hostd
-`hostd` incorporates an embedded web UI, simplifying deployment and enabling remote management capabilities, ensuring a smooth user experience across various devices.
+`hostd` is the software for storage providers. It has an embedded web UI and an API for managing storage and revenue, and earns Siacoin in exchange for storing encrypted data for the network.
### walletd
-`walletd` serves as a watch-only wallet server within the Sia ecosystem. It operates without access to private keys, solely managing addresses derived from those keys. Its primary function is to monitor the blockchain for events about specific addresses.
+`walletd` is the standalone wallet server for Siacoin (and Siafund) wallets. It supports multiple wallets and hardware wallets such as Ledger, and can index either just your own addresses or the entire chain. It can hold your seeds to send and receive, or run watch-only — tracking addresses without access to private keys.
-The server maintains knowledge of spendable outputs within the wallet, enabling it to aid in creating and broadcasting transactions that utilize these outputs. However, it is crucial to note that the exclusive task of signing transactions remains the client's responsibility.
+### renterd
-## We're here for good!
+`renterd` is the original all-in-one renter daemon, bundling a wallet, contract management, and an upload/download UI into one program. It still works, but for new projects the indexer-based stack above (or Sia Storage) is preferred.
-Not only is your data secure when using Sia, but you can also rest assured that Sia is here to stay. Sia has been operating since 2015, with its software downloaded over a million times. Moreover, thousands of terabytes of data have been uploaded to the network since its inception. Even if the Sia development team were to step away tomorrow, the network can continue to function indefinitely.
+## Longevity
-Sia has a thriving community of renters, storage providers, miners, and data storage enthusiasts and an ecosystem of open-source software and commercial data storage platforms. Discover the community ecosystem on our [official website](https://sia.tech/community-ecosystem).
+Sia has been running since 2015. Because the software is open-source and the network is decentralized, it can keep operating even without the core development team. Sia has an active community of renters, storage providers, miners, and developers, along with an ecosystem of open-source and commercial software — see the [community ecosystem](https://sia.tech/community-ecosystem).
diff --git a/get-started-with-sia/the-importance-of-your-seed.md b/get-started-with-sia/the-importance-of-your-seed.md
index 3b7c4731..eca0cce7 100644
--- a/get-started-with-sia/the-importance-of-your-seed.md
+++ b/get-started-with-sia/the-importance-of-your-seed.md
@@ -16,7 +16,7 @@ layout:
## About the Seed
-Your Sia Seed also holds the key to your Siacoin (SC) balance access to your files. It is the cornerstone of your Sia journey and the most critical information in your entire Sia experience.
+Your Sia Seed holds the key to your Siacoin (SC) balance and access to your files. It is the most important information to keep safe when using Sia.
* Sia is using BIP 39 with 128 bits of entropy and is made up of 12 words to generate your Seed.
* Your Seed is generated when you first create your Siacoin wallet in `renterd`, `hostd` or `walletd`.
@@ -24,11 +24,11 @@ Your Sia Seed also holds the key to your Siacoin (SC) balance access to your fil
## Keeping your Seed safe
-Ensuring the safety of your Sia seed is of utmost importance. It's crucial to follow the proper procedures for securely storing it. Like any other valuable digital information, never rely on its safety unless you have multiple backups.
+Keeping your Sia seed safe is important. Follow the proper procedures for securely storing it. Like any other valuable digital information, never rely on its safety unless you have multiple backups.
-* **Use a Hardware Wallet:** Hardware wallets are considered one of the most secure methods for storing seeds, as they are offline and less susceptible to hacking.
+* **Use a Hardware Wallet:** Hardware wallets store seeds offline, which makes them less susceptible to attacks that require network access.
* **Create a Paper Backup:** Write down your Seed on paper and store it securely. Make multiple copies and keep them in different safe locations.
-* **Use a Strong Password:** Encrypt your Seed with a robust and unique password and store it separately from the Seed.
+* **Use a Strong Password:** Encrypt your Seed with a strong and unique password and store it separately from the Seed.
* **Use a Biometric:** Keep your Seed in a biometric secure app that relies on Opt into using unique physical identity verification.
* **Memorize Your Seed:** If possible, memorize your Seed. However, ensure it's something you can remember accurately without writing it down.
@@ -43,5 +43,5 @@ If you lose your Seed, your Siacoin balance will become **permanently** inaccess
**The Sia development team cannot access your Seed under any circumstances.**
-In the unfortunate event that someone steals your Seed, they can easily abscond with your Siacoin balance. Thus, exercise utmost caution when sharing your Seed with any third party you do not fully trust.
+If someone steals your Seed, they can take your Siacoin balance. Be careful when sharing your Seed with any third party you do not fully trust.
{% endhint %}
diff --git a/hosting/about-hosting-on-sia.md b/hosting/about-hosting-on-sia.md
index 7a9c0257..10f79349 100644
--- a/hosting/about-hosting-on-sia.md
+++ b/hosting/about-hosting-on-sia.md
@@ -18,7 +18,7 @@ layout:
You also earn Siacoins, the cryptocurrency that powers the Sia network. Siacoins can be used to purchase your storage space or converted to other cryptocurrencies or fiat on crypto exchanges.
-Storage providers are a critical part of the ecosystem. You are contributing to the decentralized network that is the heart of Sia. Providing storage is also a more technical process than renting, and while anyone can reasonably easily set it up, there's a lot you'll want to know to maximize your setup.
+Storage providers are an important part of the ecosystem. You are contributing to the decentralized Sia network. Providing storage is also a more technical process than renting, and while anyone can set it up, there's a lot you'll want to know to get the most out of your setup.
## Earn Siacoins
@@ -41,7 +41,7 @@ Having collateral incentivizes storage providers to be online and to keep their
## Contracts
-Storage contracts are one of the most essential features of the Sia network. They allow the entire Sia ecosystem to work trustlessly – they form blockchain-enforced contracts between you and the people who rent your storage space that are automatically fulfilled.
+Storage contracts allow the Sia ecosystem to work trustlessly – they form blockchain-enforced contracts between you and the people who rent your storage space that are automatically fulfilled.
### Contract Formation
@@ -75,7 +75,7 @@ Your host submits storage proofs automatically, but only if it is **online**, th
### Siafund Fee
-A **3.9% fee** is deducted from the total contract payout and distributed to [Siafund](../siafunds/learn-about-siafunds.md) holders. This fee applies to both the host's revenue and the host's collateral. This is why setting your collateral too high can hurt your score — it increases the total fee that renters must pay when forming a contract with you.
+A **3.9% fee** is deducted from the total contract payout and distributed to Siafund holders. This fee applies to both the host's revenue and the host's collateral. This is why setting your collateral too high can hurt your score — it increases the total fee that renters must pay when forming a contract with you.
### Payout Timeline
@@ -85,7 +85,7 @@ Because contracts resolve periodically rather than paying out continuously, your
## Storage Provider Scoring
-Your storage provider score is one of the most critical factors determining how you'll fare as a storage provider. This is based on several metrics – some that you can directly affect, some that improve or diminish over time based on your performance.
+Your storage provider score is a key factor determining how you'll fare as a storage provider. This is based on several metrics – some that you can directly affect, some that improve or diminish over time based on your performance.
Sia is a decentralized network - the code to evaluate these scoring metrics is contained within each renter's Sia instance. For that reason, each Sia renter you encounter scores storage providers independently, so you may be scored differently among different renters. As a storage provider, you do not have one overall score across the Sia network but many scores with many renters based on the metrics described below. Any website or service that benchmarks your storage node can only show you a score based on their own metrics, which may differ from what a renter comes up with.
@@ -131,7 +131,7 @@ This is how many Siacoins you're willing to lose if you don't fulfill the rental
You should normally set your collateral to around **2-3x your base storage price** as a starting point in order to maximize your storage node's score in this area. For example, if you've priced your storage at 50 SC/TB, you should set your collateral at 100-150 SC/TB.
* If you set your collateral **too low**, your storage node's score will be reduced, because renters will have no reason to trust you as a storage provider if you have little or nothing to lose by going offline.
-* If you set your collateral **too high**, this can also decrease your storage node's score. Renters pay a fee based on a percentage of your collateral that goes towards [Siafunds](https://docs.sia.tech/siafunds/learn-about-siafunds) - if your collateral is set very high, the fee a renter pays, as a result, will be very high, which can decrease your storage node's score.
+* If you set your collateral **too high**, this can also decrease your storage node's score. Renters pay a fee based on a percentage of your collateral that goes towards Siafunds - if your collateral is set very high, the fee a renter pays, as a result, will be very high, which can decrease your storage node's score.
**Monitoring Your Collateral**
@@ -179,7 +179,7 @@ Stay updated. Your storage node score drops if you're not running the latest ver
## Third-Party Storage Provider Scoring
-We have an incredible community building on Sia. Third-party sites can develop their methods for scoring storage providers based on various metrics. For example, Sia Central has developed a [Host Browser](https://hosts.siacentral.com/), which allows you to browse and compare storage providers.
+Third-party sites can develop their own methods for scoring storage providers based on various metrics. For example, Sia Central has developed a [Host Browser](https://hosts.siacentral.com/), which allows you to browse and compare storage providers.
These benchmarks differ from the core Sia protocol but are still helpful and may be used to help monitor and improve your storage node over time.
@@ -188,7 +188,7 @@ Once you've started providing storage, you'll probably want to keep an eye on yo
{% hint style="success" %}
#### **Getting Started with `hostd`**
-Contributing your storage space couldn't be any simpler by using Sia's `hostd` software!
+You can contribute your storage space using Sia's `hostd` software.
-Start providing storage on Sia with the official [`hostd` software](https://sia.tech/software/hostd) and exploring our step-by-step [Setting up hostd ](setting-up-hostd/)guide.
+Start providing storage on Sia with the official [`hostd` software](https://sia.tech/software/hostd) and our step-by-step [Setting up hostd ](setting-up-hostd/)guide.
{% endhint %}
diff --git a/hosting/announcing-your-host.md b/hosting/announcing-your-host.md
index e6ad2056..81c48698 100644
--- a/hosting/announcing-your-host.md
+++ b/hosting/announcing-your-host.md
@@ -16,7 +16,7 @@ layout:
Now that your storage node has been configured and finished syncing, you can announce your node to the network.
-Announcing your storage node serves as the bridge between your fully prepared node and potential renters seeking storage solutions. This process publishes information about your storage node, including its network address and public key, onto the blockchain, allowing renters to discover your node and establish contracts.
+Announcing publishes information about your storage node, including its network address and public key, onto the blockchain, allowing renters to discover your node and establish contracts.
{% hint style="warning" %}
An announcement transaction incurs a small fee in Siacoins (SC), which will be deducted from your wallet. Ensure your `hostd` wallet is funded by checking out [Transferring Siacoins](transferring-siacoins.md).
@@ -31,7 +31,7 @@ Click on the **Announce** button in the top right-hand corner.
Finally, check the announcement fee and click **Announce** in the dialog to confirm.
{% hint style="success" %}
-Congratulation! Your storage node has been successfully announced to the network and is now ready to be discovered by renters and establish contracts.
+Your storage node has been announced to the network and can now be discovered by renters and establish contracts.
{% endhint %}
## Check your storage node's status
diff --git a/hosting/configuring-your-host/README.md b/hosting/configuring-your-host/README.md
index 14e6e2ef..05371081 100644
--- a/hosting/configuring-your-host/README.md
+++ b/hosting/configuring-your-host/README.md
@@ -14,7 +14,7 @@ layout:
# Storage Node Configuration
-Setting up your storage node on Sia also involves configuring essential parameters such as storage, bandwidth, and other critical variables. These configurations are vital to maintaining your storage node's health, ensuring it can effectively provide storage services to renters, and determining how much you earn from providing storage on the network.
+Setting up your storage node on Sia involves configuring parameters such as storage, bandwidth, and other variables. These configurations affect your storage node's health, its ability to provide storage to renters, and how much you earn from providing storage on the network.
Go to `hostd`. If you're asked to unlock the UI, use your custom password if you've set one. If you haven't got a wallet set up in `hostd`, visit our [Setting up `hostd`](../setting-up-hostd/) guide; otherwise, choose from the sidebar **Configuration**.
@@ -36,7 +36,7 @@ The **Accepting Contracts** setting determines whether your storage node will ac
Setting your storage node's network **Address** is essential because it's published to the blockchain and used by renters to connect to your node. Some users use their public IP address, but we recommend setting up a domain.
{% hint style="info" %}
-You have several options for setting up Dynamic DNS. We recommend utilizing straightforward, no-cost services like [DuckDNS](dynamic-dns/duckdns.md) or [Cloudflare](dynamic-dns/cloudflare-advanced.md). Additionally, you can choose to purchase a custom domain from a registrar.
+You have several options for setting up Dynamic DNS. We recommend free services like [DuckDNS](dynamic-dns/duckdns.md) or [Cloudflare](dynamic-dns/cloudflare-advanced.md). You can also purchase a custom domain from a registrar.
Alternatively, you can set up a public IP address by clicking [here](https://icanhazip.com), which will display the public IP address that you can then copy to your clipboard.
{% endhint %}
@@ -58,7 +58,7 @@ The prices you select will determine how much you earn from providing storage.
When setting your prices, you are in direct competition with other storage providers on the network. Should your prices be excessively high, renters may opt for alternative storage providers. Conversely, if your prices are exceedingly low, you may not generate sufficient earnings to offset your operational expenses.
-Storage providers are encouraged to explore various pricing options and adjust as needed to achieve the optimal balance between earnings and utilization. Nevertheless, we have provided the pricing recommendations table below for guidance.
+Storage providers are encouraged to try various pricing options and adjust as needed to balance earnings and utilization. The pricing recommendations table below is provided for guidance.
{% hint style="warning" %}
Please be aware that these recommendations are only suggestions, and you can modify your pricing anytime.
diff --git a/hosting/configuring-your-host/dynamic-dns/README.md b/hosting/configuring-your-host/dynamic-dns/README.md
index 87b6d995..feac55c7 100644
--- a/hosting/configuring-your-host/dynamic-dns/README.md
+++ b/hosting/configuring-your-host/dynamic-dns/README.md
@@ -4,10 +4,10 @@ Most ISPs assign dynamic IP addresses for their residential and small business a
In contrast, a static IP address remains fixed and does not change. It is manually assigned to a device or service, providing a stable point of contact for hosting purposes. Static IPs are typically used by large organizations, dedicated servers, or services that require constant accessibility. While static IPs offer reliable connectivity, they are generally more expensive than dynamic IPs.
-Dynamic DNS (DDNS) services offer a practical solution for hosts with dynamic IP addresses. `hostd` Has built-in DDNS and integrates with multiple services, including Cloudflare, AWS Route53, DuckDNS, and No-IP. By using `hostd`Its built-in DDNS hosts get the benefits of DDNS without needing to download and set up external software.
+Dynamic DNS (DDNS) services help hosts with dynamic IP addresses. `hostd` has built-in DDNS and integrates with multiple services, including Cloudflare, AWS Route53, DuckDNS, and No-IP. With `hostd`'s built-in DDNS, hosts can use DDNS without downloading and setting up external software.
## Benefits of DDNS
-**Seamless Connectivity:** Dynamic DNS enables hosts with dynamic IP addresses to stay easily connectable, even when their IP changes. DDNS services monitor and update the IP address associated with a domain name in real-time. This automated process redirects incoming traffic to the new IP, ensuring consistent accessibility for hosted services.
+**Connectivity:** Dynamic DNS lets hosts with dynamic IP addresses stay connectable, even when their IP changes. DDNS services monitor and update the IP address associated with a domain name. When the IP changes, incoming traffic is redirected to the new IP.
-**Cost-Efficiency:** With dynamic DNS, hosts can avoid the need for frequent IP announcements, which can incur costs in terms of time, effort, and even Siacoin. Active DNS services provide a reliable and automated updating of IP address information. This cost-effective approach allows hosts to focus on delivering their services rather than managing IP logistics.
+**Cost:** With dynamic DNS, hosts can avoid frequent IP announcements, which cost time, effort, and Siacoin. DDNS services update IP address information automatically, so hosts don't have to manage it manually.
diff --git a/hosting/configuring-your-host/dynamic-dns/cloudflare-advanced.md b/hosting/configuring-your-host/dynamic-dns/cloudflare-advanced.md
index 03a64f56..9d729250 100644
--- a/hosting/configuring-your-host/dynamic-dns/cloudflare-advanced.md
+++ b/hosting/configuring-your-host/dynamic-dns/cloudflare-advanced.md
@@ -4,7 +4,7 @@ description: Learn how to set up dynamic DNS in hostd with Cloudflare
# Cloudflare (Advanced)
-Cloudflare DNS is a globally distributed, fast, secure, and free Domain Name System (DNS) service that offers top-level domain resolution with robust security features and increased site performance. This guide will walk you through setting up Cloudflare for DDNS in `hostd`.
+Cloudflare DNS is a free Domain Name System (DNS) service. This guide walks you through setting up Cloudflare for DDNS in `hostd`.
## Things you'll need
@@ -73,7 +73,7 @@ Once you have set the permissions, click "Continue to summary." On the summary s
## Configure hostd
-It's finally time to configure `hostd` and enable DDNS.
+Now configure `hostd` and enable DDNS.
1. Access the `hostd` UI, `http://localhost:9980` by default
2. Click the "Configuration" icon in the sidebar
diff --git a/hosting/configuring-your-host/dynamic-dns/duckdns.md b/hosting/configuring-your-host/dynamic-dns/duckdns.md
index cf75a8cc..46e6f923 100644
--- a/hosting/configuring-your-host/dynamic-dns/duckdns.md
+++ b/hosting/configuring-your-host/dynamic-dns/duckdns.md
@@ -4,7 +4,7 @@ description: Learn how to set up dynamic DNS in hostd with DuckDNS
# DuckDNS
-DuckDNS is a free and reliable DDNS provider that offers a straightforward solution for associating a dynamic IP address with a domain name. It's important to note that DuckDNS only supports domains in the format of \`\*.duckdns.org\`. In this guide, we will walk you through the process of configuring DDNS in `hostd` using DuckDNS, enabling you to maintain uninterrupted connectivity to your storage provider, even with a dynamic IP address.
+DuckDNS is a free DDNS provider for associating a dynamic IP address with a domain name. Note that DuckDNS only supports domains in the format of \`\*.duckdns.org\`. This guide walks you through configuring DDNS in `hostd` using DuckDNS, so your storage provider stays reachable even with a dynamic IP address.
## Create a DuckDNS domain
diff --git a/hosting/setting-up-hostd/README.md b/hosting/setting-up-hostd/README.md
index 6e694308..ec224bc7 100644
--- a/hosting/setting-up-hostd/README.md
+++ b/hosting/setting-up-hostd/README.md
@@ -1,2 +1,10 @@
# Setting up hostd
+`hostd` is the Sia Foundation's software for storage providers. It stores encrypted data for the network and earns Siacoin (SC) in return. These guides walk you through installing and configuring it.
+
+Choose an install method:
+
+- [Linux](linux/) — apt package (Debian or Ubuntu) or a manual binary. Recommended for a dedicated host.
+- [Docker](docker.md)
+- [macOS](macos.md) — installed with Homebrew.
+- [Windows](windows.md) — desktop app.
diff --git a/hosting/setting-up-hostd/docker.md b/hosting/setting-up-hostd/docker.md
index f3a2aed9..b87e455a 100644
--- a/hosting/setting-up-hostd/docker.md
+++ b/hosting/setting-up-hostd/docker.md
@@ -24,7 +24,7 @@ This guide will walk you through setting up `hostd` using Docker compose. At the
## Pre-requisites
-To ensure you will not run into any issues with running `hostd` it is recommended your system meets the following requirements:
+The following requirements are recommended for running `hostd`:
* **Hardware Requirements:** A stable setup that meets the following specifications is recommended. Not meeting these requirements may result in fewer contracts from renters or the loss of collateral.
- A quad-core CPU
@@ -94,7 +94,7 @@ Finally, you will be asked if you want to configure advanced settings for `hostd
## Running `hostd`
-Now that you have `hostd` successfully installed and configured, it is time to run it. Use the following command to start `hostd`:
+Now that you have `hostd` installed and configured, you can run it. Use the following command to start `hostd`:
```console
docker compose up -d
@@ -107,7 +107,7 @@ Once `hostd` has successfully started, you can access the web UI by opening your
{% hint style="success" %}
-Congratulations, you have successfully set up `hostd`.
+`hostd` is now set up.
{% endhint %}
## Checking the container status
@@ -132,7 +132,7 @@ docker compose logs hostd
## Upgrading `hostd`
-It is essential to keep your host up to date. New versions of `hostd` are released regularly and contain bug fixes and performance improvements.
+Keep your host up to date. New versions of `hostd` are released regularly and contain bug fixes and performance improvements.
To upgrade your `hostd` to the newest version, make sure you have shut down `hostd` and then run the following:
@@ -141,5 +141,5 @@ docker compose pull && docker compose up -d
```
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `hostd`!
+`hostd` is now updated to the latest version.
{% endhint %}
diff --git a/hosting/setting-up-hostd/linux/README.md b/hosting/setting-up-hostd/linux/README.md
index b15734dc..08b74ff0 100644
--- a/hosting/setting-up-hostd/linux/README.md
+++ b/hosting/setting-up-hostd/linux/README.md
@@ -14,7 +14,7 @@ layout:
# Linux
-`hostd` is designed to be run as a background service to rent out unused storage space to peers. This guide will walk you through the process of installing and configuring `hostd` on a Linux machine. Linux is the recommended operating system for running `hostd` because of its stability. We recommend using a Debian-based distribution, such as Ubuntu or Debian, but `hostd` should work on any modern Linux distribution. The setup guides in these docs are primarily focused on installing using `apt`, but `hostd` can also be installed as a binary manually or run in a Docker container.
+`hostd` can be run as a background service to rent out unused storage space to peers. This guide will walk you through the process of installing and configuring `hostd` on a Linux machine. Linux is the recommended operating system for running `hostd` because of its stability. We recommend using a Debian-based distribution, such as Ubuntu or Debian, but `hostd` should work on any modern Linux distribution. The setup guides in these docs are primarily focused on installing using `apt`, but `hostd` can also be installed as a binary manually or run in a Docker container.
- [Debian](debian.md)
- [Ubuntu](ubuntu.md)
diff --git a/hosting/setting-up-hostd/linux/debian.md b/hosting/setting-up-hostd/linux/debian.md
index d1d9cac0..1f5d2de4 100644
--- a/hosting/setting-up-hostd/linux/debian.md
+++ b/hosting/setting-up-hostd/linux/debian.md
@@ -23,7 +23,7 @@ This guide will walk you through setting up `hostd` on Linux. At the end of this
## Pre-requisites
-To ensure you will not run into any issues with running `hostd` it is recommended your system meets the following requirements:
+The following requirements are recommended for running `hostd`:
* **Operating System Compatibility:** `hostd` is supported on the following Debian versions:
- Trixie (Debian 13)
diff --git a/hosting/setting-up-hostd/linux/other.md b/hosting/setting-up-hostd/linux/other.md
index a45e00c1..7baad07f 100644
--- a/hosting/setting-up-hostd/linux/other.md
+++ b/hosting/setting-up-hostd/linux/other.md
@@ -13,7 +13,7 @@ layout:
visible: true
---
-# Linux
+# Other Linux Distributions
This guide will walk you through setting up `hostd` on Linux. At the end of this guide, you should have the following:
@@ -23,7 +23,7 @@ This guide will walk you through setting up `hostd` on Linux. At the end of this
## Pre-requisites
-To ensure you will not run into any issues with running `hostd` it is recommended your system meets the following requirements:
+The following requirements are recommended for running `hostd`:
* **Operating System Compatibility:** `hostd` is supported on the following Linux versions:
- Trixie (Debian 13)
@@ -96,11 +96,11 @@ rm -rf hostd_linux_arm64.zip
`hostd` uses BIP-39 12-word recovery phrases. It does not support legacy 28/29-word `siad` seeds.
{% endhint %}
-1. Before running the `hostd` configuration wizard, make sure to `cd` into the `hostd` runtime folder you created in the last section. Then run the `hostd` configuration wizard. This will generate a `hostd.yml` file that is used by `hostd` on start-up.
+1. Run the `hostd` configuration wizard from your `hostd` folder. Setting `HOSTD_CONFIG_FILE` tells the wizard to write `hostd.yml` into this folder; otherwise, on Linux it would be saved to `/etc/hostd/hostd.yml`, which requires root. This `hostd.yml` is used by `hostd` on start-up.
```console
cd /path/to/hostd/folder
- hostd config
+ HOSTD_CONFIG_FILE=hostd.yml hostd config
```
## Start `hostd`
@@ -128,7 +128,7 @@ If you do not have a desktop environment:
## 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.
+Keep your host up to date. New versions of `hostd` are released regularly and contain bug fixes and performance improvements.
**To update:**
@@ -174,5 +174,5 @@ rm -rf hostd_linux_arm64.zip
```
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `hostd`!
+`hostd` is now updated to the latest version.
{% endhint %}
diff --git a/hosting/setting-up-hostd/linux/ubuntu.md b/hosting/setting-up-hostd/linux/ubuntu.md
index dafe2aaf..fb1bd7e9 100644
--- a/hosting/setting-up-hostd/linux/ubuntu.md
+++ b/hosting/setting-up-hostd/linux/ubuntu.md
@@ -24,7 +24,7 @@ This guide will walk you through setting up `hostd` on Linux. At the end of this
## Pre-requisites
-To ensure you will not run into any issues with running `hostd` it is recommended your system meets the following requirements:
+The following requirements are recommended for running `hostd`:
* **Operating System Compatibility:** `hostd` is supported on the following Ubuntu versions:
- Plucky (Ubuntu 25.04)
@@ -79,7 +79,7 @@ sudo apt update
sudo apt install hostd
```
-
+
**3. Verify `hostd` was installed successfully**
@@ -89,7 +89,7 @@ Run the following command to see the version of `hostd` that was installed:
hostd version
```
-
+
## Configure `hostd`
diff --git a/hosting/setting-up-hostd/macos.md b/hosting/setting-up-hostd/macos.md
index f6511b80..de8d070b 100644
--- a/hosting/setting-up-hostd/macos.md
+++ b/hosting/setting-up-hostd/macos.md
@@ -24,7 +24,7 @@ This guide will walk you through setting up `hostd` on macOS. At the end of this
## Pre-requisites
-To ensure you will not run into any issues with running `hostd` it is recommended your system meets the following requirements:
+The following requirements are recommended for running `hostd`:
* **System Updates:** Ensure that your macOS version is up to date with the latest system updates. These updates can contain important security fixes and improvements.
@@ -37,7 +37,7 @@ To ensure you will not run into any issues with running `hostd` it is recommende
* **Network Access:** `hostd` requires a stable internet connection and open network access to store and retrieve data on the Sia network.
-* **Software Requirements:** Before installing `hostd`, you will need to install the [Homebrew](https://brew.sh) package manager. This will allow you to install and upgrade `hostd` easily.
+* **Software Requirements:** Before installing `hostd`, you will need to install the [Homebrew](https://brew.sh) package manager. This is used to install and upgrade `hostd`.
## Installing `hostd`
@@ -91,7 +91,7 @@ Finally, you will be asked if you want to configure advanced settings for `hostd
## Running `hostd`
-Now that you have `hostd` successfully installed and configured, it is time to run it. Use the following command to start `hostd`:
+Now that you have `hostd` installed and configured, you can run it. Use the following command to start `hostd`:
```console
hostd
@@ -108,12 +108,12 @@ If the `hostd` web UI does not open. You can access it by opening your browser a
{% hint style="success" %}
-Congratulations, you have successfully set up `hostd`.
+`hostd` is now set up.
{% endhint %}
## Upgrading `hostd`
-It is essential to keep your host up to date. New versions of `hostd` are released regularly and contain bug fixes and performance improvements.
+Keep your host up to date. New versions of `hostd` are released regularly and contain bug fixes and performance improvements.
To upgrade your `hostd` to the newest version, make sure you have shut down `hostd` and then run the following:
@@ -132,5 +132,5 @@ hostd version
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `hostd`!
+`hostd` is now updated to the latest version.
{% endhint %}
diff --git a/hosting/setting-up-hostd/windows.md b/hosting/setting-up-hostd/windows.md
index 05fd391e..baed0877 100644
--- a/hosting/setting-up-hostd/windows.md
+++ b/hosting/setting-up-hostd/windows.md
@@ -15,7 +15,7 @@ layout:
# Windows Desktop App: `hostd`
-The `hostd` desktop app provides a user-friendly web UI to start providing storage on the Sia network. By the end of this guide, you will have:
+The `hostd` desktop app provides a web UI to start providing storage on the Sia network. By the end of this guide, you will have:
* Installed the `hostd` desktop application.
* Created a `hostd` wallet
@@ -78,12 +78,12 @@ When you first run `hostd`, Windows Security may ask to allow public and private
{% hint style="success" %}
-**Success!** `hostd` is now running on your Windows system, and you’re ready to start providing storage on the Sia network.
+`hostd` is now running on your Windows system, and you can start providing storage on the Sia network.
{% endhint %}
## Configure
-You can customize `hostd` through the desktop app, which provides full control over all available settings.
+You can configure `hostd` through the desktop app, which exposes all available settings.
On **Windows**, you can access the `hostd` configurations by going to the taskbar, expanding the up arrow to see hidden icons, and double-clicking the `hostd` app. This will open the configuration window and let you customize its behavior.
@@ -103,18 +103,18 @@ There are several configurable settings in `hostd`. Below is a breakdown of what
| RHP4 port | Listening port for incoming storage traffic |
{% hint style="warning" %}
-Always **save and restart daemon** after making configuration changes to ensure they are applied.
+Always **save and restart daemon** after making configuration changes so they are applied.
{% endhint %}
-You can monitor your node’s activity and track changes by checking the logs. These provide detailed information about the system, network connections, API endpoints, S3 interface, and autopilot operations, helping you understand what your node is doing at any given time.
+You can monitor your node’s activity and track changes by checking the logs. These provide information about the system, network connections, API endpoints, S3 interface, and autopilot operations.
## Update
-`hostd` updates regularly with bug fixes, performance improvements, and new features. Updating your node ensures stability and compatibility with the Sia network.
+`hostd` updates regularly with bug fixes, performance improvements, and new features. Updating your node keeps it compatible with the Sia network.
-On Windows, the app downloads updates automatically and notifies you when they’re ready. Simply restart the app to run the latest version.
+On Windows, the app downloads updates automatically and notifies you when they’re ready. Restart the app to run the latest version.
{% hint style="info" %}
You can always check for the version of the software at the bottom of the app interface.
diff --git a/hosting/transferring-siacoins.md b/hosting/transferring-siacoins.md
index 9f28f09d..9bf3c802 100644
--- a/hosting/transferring-siacoins.md
+++ b/hosting/transferring-siacoins.md
@@ -14,7 +14,7 @@ layout:
# Transferring Siacoins
-Whether you're sending Siacoins to an exchange or receiving from a friend, `hostd` facilitates the transfer of Siacoins (SC). You can check the transaction status, easily achieved via the UI.
+Whether you're sending Siacoins to an exchange or receiving from a friend, `hostd` can transfer Siacoins (SC). You can also check the transaction status via the UI.
## Sending Siacoins
@@ -42,7 +42,7 @@ Click **Setup** to change something. If it's all good, click **Broadcast transac
Confirmation of a successful transaction broadcasted
-You'll immediately get a confirmation that your transaction has been successfully broadcasted.
+You'll get a confirmation that your transaction has been broadcast.
### Checking the status
diff --git a/miscellaneous/sia-brand-guidelines.md b/miscellaneous/sia-brand-guidelines.md
index 0fdf016c..b26e32b3 100644
--- a/miscellaneous/sia-brand-guidelines.md
+++ b/miscellaneous/sia-brand-guidelines.md
@@ -14,15 +14,15 @@ layout:
# Brand Guidelines
-Third-party projects constitute an integral part of the Sia ecosystem. They broaden the range of applications on Sia and enhance the network through solutions that are not actively being developed by our team.
+Third-party projects are an important part of the Sia ecosystem. They broaden the range of applications on Sia and add solutions that are not developed by our team.
We aim for users to discern between core and non-core projects for several reasons:
* Non-core projects often involve some level of centralization, which is entirely acceptable. Users benefit from having choices, and centralization allows for the implementation of features that are more accessible to achieve compared to those on Sia's core infrastructure.
* There's the potential for confusion where users might mistake your project for something created by the core team. We want to ensure that users know where to go for help.
-* Acknowledge your dedication to your project; we desire to give it the recognition it deserves, allowing it to stand out prominently.
+* We want your project to get credit for your work and to stand on its own.
-These Sia brand guidelines will assist those developing their project by ensuring clarity, consistency, and distinction between other projects and core Sia offerings.
+These guidelines help developers keep their projects clear and distinct from core Sia projects.
## Logo and Branding Usage
@@ -69,5 +69,5 @@ If you would like to showcase your project's integration with Sia, you can add a
| Light 50% |  | N/A | .svg |
{% hint style="info" %}
-We're eagerly anticipating what you'll create! If you have any questions regarding our Sia branding guidelines, please don't hesitate to reach out via [email](mailto:hello@sia.tech) or [Discord](https://sia.tech/discord).
+If you have any questions about these branding guidelines, reach out via [email](mailto:hello@sia.tech) or [Discord](https://sia.tech/discord).
{% endhint %}
diff --git a/miscellaneous/siacoin-total-supply.md b/miscellaneous/siacoin-total-supply.md
index 0cd697b4..ba523c5d 100644
--- a/miscellaneous/siacoin-total-supply.md
+++ b/miscellaneous/siacoin-total-supply.md
@@ -14,7 +14,7 @@ layout:
# Siacoin Total Supply
-The total supply of Siacoins (SC) is unlimited; there will never be a cap on the number of Siacoins generated. Humans produce an extensive amount of data, making it practically limitless. When Sia becomes the industry-standard storage layer of the internet, the network will require a significant quantity of Siacoins to fulfill all the associated contracts.
+The total supply of Siacoins (SC) is unlimited; there will never be a cap on the number of Siacoins generated. The amount of data that can be stored grows over time, and as Sia is used to store more data, the network requires more Siacoins to fund the associated contracts.
As of June 6, 2025, approximately 60.5 billion coins have been created, with the new coin introduction slowing down as each new block is produced.
@@ -22,7 +22,7 @@ Additionally, miners would lose their incentive to continue providing services t
## Creation of new Siacoins
-New Siacoins are created through proof-of-work mining. Over 56 billion Siacoins are circulating, which will continue to increase. Sia is poised to become the foundational storage layer of the internet, necessitating billions of Siacoins to accommodate the petabytes and exabytes of data that will be stored on our platform.
+New Siacoins are created through proof-of-work mining. Over 56 billion Siacoins are circulating, and that number will continue to increase. Storing more data on the network requires more Siacoins to fund storage contracts.
{% hint style="info" %}
The number of Siacoins created for each block is 300,000 minus the height. This means a block with a block height of 200,000 has created 100,000 Siacoins. After a height of 270,000, the block reward won't get lower, and all blocks will have a reward of 30,000 Siacoins.
@@ -30,13 +30,13 @@ The number of Siacoins created for each block is 300,000 minus the height. This
## Supply structure changes
-Sia version 1.5.4 introduced a network hard fork, which, in turn, established the Sia Foundation—an emerging non-profit organization dedicated to supporting, developing, and promoting the Sia network. The Sia Foundation led to a minor alteration in the supply structure since it received continuous funding through a block subsidy of 30,000 Siacoins per block, disbursed every 4,380 blocks. Additionally, the hard fork included an initial offering of approximately 1.57 billion Siacoins to kickstart the Foundation's operations and finance its initial development and activities.
+Sia version 1.5.4 introduced a network hard fork that established the Sia Foundation, a non-profit organization that supports, develops, and promotes the Sia network. This changed the supply structure: the Foundation receives funding through a block subsidy of 30,000 Siacoins per block, disbursed every 4,380 blocks. The hard fork also included an initial offering of approximately 1.57 billion Siacoins to fund the Foundation's initial operations.
-Consequently, this resulted in a slight, temporary increase in the inflation schedule for a single year, with an uptick of a few percentage points, before swiftly returning to nearly pre-fork levels.
+This caused a temporary increase in the inflation schedule for a single year, of a few percentage points, before returning to near pre-fork levels.
## Siacoin inflation
-Inflation is an inherent feature of Siacoin designed to accommodate various factors that lead to the gradual reduction of coins in circulation. These factors include the coins locked in contracts as collateral, lost coins, coins burnt due to failed storage contracts. Over time, this inflation diminishes significantly, yet it plays a crucial role in safeguarding the network by offering block rewards to miners.
+Inflation accommodates factors that reduce the number of coins in circulation. These include coins locked in contracts as collateral, lost coins, and coins burnt due to failed storage contracts. Over time, inflation diminishes, but it continues to secure the network by providing block rewards to miners.
| Year | % Growth in total Siacoins |
| ------------------- | -------------------------- |
diff --git a/renting/about-renting.md b/renting/about-renting.md
index a8755983..274b17fd 100644
--- a/renting/about-renting.md
+++ b/renting/about-renting.md
@@ -14,45 +14,124 @@ layout:
# About Storing Your Data
-Storing data on Sia means you upload files on the Sia storage network to other users who have made their space available, called **hosts**. The term **renter** is used to describe an individual or entity that creates storage contracts with **hosts**:
+Storing data on Sia means uploading your files to independent operators around the world who have made their disk space available, called **storage providers** (or **hosts**). Your data is encrypted and split into redundant pieces on your own machine before it ever leaves it, then spread across many unrelated storage providers so that no single operator — or outage — can read it or take it offline.
-* To store a certain amount of data.
-* For a certain period.
-* For a certain amount of Siacoin (SC).
+Coordinating all of that (finding providers, forming contracts, placing data, and repairing it over time) is handled for you by the rest of the Sia storage stack, described below.
-## The Marketplace
+## How storage works on Sia
-\
-The Sia storage network is an open marketplace to connect consumers with providers for their data. The cost associated with this storage is competitively determined by hosts and renters within the market. If hosts discover that reducing prices allows them to secure more data for storage, they are inclined to do so. Similarly, if renters are willing to pay higher rates for storage with high-quality hosts, those hosts may opt to increase their prices.
+Modern Sia storage is built from a few distinct pieces, each with a single job. This is the preferred approach for new projects; the older all-in-one `renterd` renter still works, but it is no longer the recommended starting point.
-The storage price is denominated in Siacoins, and you will need Siacoins to form storage contracts and upload data. Hosts have the autonomy to establish their prices, fostering a competitive marketplace where top-quality and dependable hosts vie for storage contracts from those seeking to store data. Network pricing averages around **$3 per terabyte per month,** including 3x redundancy.
+* **Storage providers (`hostd`)** — the nodes that actually store data. They run Sia's hosting software, contribute disk space and bandwidth, and earn Siacoin (SC) by storing encrypted **shards** and proving over time that the data is still available. They never see filenames, object IDs, or anything about the data they hold.
-## **About contracts**
+* **Indexers (`indexd`) — contract management.** An indexer sits between applications and storage providers. It forms and maintains the **storage contracts** with providers, tracks where each object's shards live, monitors their health, and repairs data in the background when redundancy drops. It also enforces a simple access model so multiple apps can share one indexer safely. An indexer only ever sees encrypted metadata and the storage layout — never your plaintext data. This is the "renter" role in the new architecture.
-Storage contracts are one of the most essential features of the Sia network. They allow the entire Sia ecosystem to work trustlessly – they form blockchain-enforced agreements between you and your storage providers that are automatically resolved when each party meets their obligation. In other words, they let you form contracts with people you don't know to store your data.
+* **SDKs — data storage and retrieval.** The [Sia Storage SDKs](https://devs.sia.storage) (available for Rust, Go, Python, and JavaScript) run inside your application. They encrypt your data and metadata, [erasure-code](https://devs.sia.storage/docs/core-concepts/erasure-coding) it into redundant shards, and upload or download those shards **directly** to and from storage providers, using the layout and access information supplied by the indexer. Encryption keys stay with you; neither the indexer nor the providers can read your data.
-* **Hosts** are responsible for data storage and receive compensation only after demonstrating successful storage for the agreed-upon period.
-* **Renters** are tasked with paying the host and are charged solely for the data storage they utilize.
+* **Apps — built on the SDKs.** Applications use an SDK to talk to an indexer and storage providers. The indexer deliberately stays narrow (objects, metadata, health, access), so anything higher-level — filenames, folders, search, sharing, version history — is built at the app layer on top of the SDK.
-By default, storage contracts last three months and automatically form when you upload your files.
+In short: your **app** uses an **SDK** to encrypt and move data to and from **storage providers**, while an **indexer** manages the contracts and keeps that data healthy.
-## **Fees**
+{% hint style="success" %}
+**You don't have to run any of this yourself.** [Sia Storage](https://sia.storage) is a hosted indexer and app that gives you **50 GB free** with nothing to install or maintain. Run your own [`indexd`](setting-up-indexd/) only if you want to control the indexer infrastructure yourself.
+{% endhint %}
-As a renter, you pay for the cost of storing data on the network. There are also some other fees that you're responsible for, such as:
+## Storing and retrieving data with the SDKs
-* **Contract Formation Fees** – Creating storage contracts on the blockchain requires a transaction, and minimal fees are associated with this. Contract formation fees are one-time per contract and usually cost only a handful of Siacoins.
-* **Bandwidth Fees** – You pay for the bandwidth you use to upload or download files. This can also include wear and tear fees set by the host to help pay for their physical storage devices.
+Applications never deal with storage providers by hand. Instead they use a **Sia Storage SDK** — a client library that handles encryption, redundancy, and transfer, and coordinates with an indexer on your behalf. SDKs are available for Rust, Go, Python, and JavaScript:
+
+{% tabs %}
+{% tab title="Rust" %}
+```sh
+cargo add sia_storage
+```
+{% endtab %}
+
+{% tab title="Go" %}
+```sh
+go get go.sia.tech/siastorage@latest
+```
+{% endtab %}
+
+{% tab title="Python" %}
+```sh
+pip install sia-storage
+```
+{% endtab %}
+
+{% tab title="JavaScript" %}
+```sh
+npm install @siafoundation/sia-storage
+```
+{% endtab %}
+{% endtabs %}
+
+Everything that touches your data happens locally, inside the SDK:
+
+* **On upload**, the SDK encrypts your file and its metadata, [erasure-codes](https://devs.sia.storage/docs/core-concepts/erasure-coding) the data into many redundant shards, and uploads those encrypted shards directly to storage providers using the contracts and layout the indexer provides. It then *pins* the resulting object to the indexer so the object becomes listable and can be repaired over time.
+* **On download**, the SDK asks the indexer where an object's shards live, fetches enough of them from storage providers, verifies their integrity, and decrypts the data locally before streaming it back to your application.
+
+Data is addressed by a content-derived **object ID** rather than a file path, and objects are immutable — changing the data produces a new object. Object metadata is opaque, application-defined, and encrypted, so the indexer stores it but can't read it. Because every encryption key stays inside your app, neither the indexer nor the storage providers can ever see your data, your metadata, or even your filenames.
+
+For complete upload, download, and object-management examples in each language, see the [Quickstart](https://devs.sia.storage/docs/quickstart) in the Sia Developer Portal.
+
+## Building apps
+
+In the Sia ecosystem, an **app** is the cryptographic identity of software acting on a user's behalf — not a user account, a wallet, or a storage provider. That identity is what lets a user grant a piece of software access to their data, keep each app's data isolated, and revoke that access later.
+
+An app's identity is built from two parts:
+
+* **App ID** — a 32-byte identifier you (the developer) choose once and ship with your software. It's the same across every install of your app, and because it's an input to key derivation, it must never change after release.
+* **App Key** — a per-user signing key derived from the user's **recovery phrase** and your App ID. It's unique to each (user, app) pair, stored securely by your app, and used to sign and authorize every request to the indexer. The recovery phrase itself is never stored or transmitted by the app — only the derived key is kept.
+
+Because the App Key is derived from both the recovery phrase *and* the App ID, two apps from the same user produce different keys and **cannot see or modify each other's data**. This sandboxing is structural — enforced by cryptography, not by server-side rules. Before an app can act for a user it must be explicitly approved once, and approval can be revoked at any time, immediately cutting off that app's access.
+
+Indexers deliberately stay narrow: they track objects, metadata, health, and access, and nothing more. The higher-level features your users expect — filenames, folders, search, sharing links, version history — are all built at the app layer on top of the SDK's simple, object-centric interface.
+
+{% hint style="info" %}
+#### Building on Sia
+
+Guides, SDK references, and the full app identity and onboarding model live in the [Sia Developer Portal](https://devs.sia.storage). Start with the [Quickstart](https://devs.sia.storage/docs/quickstart), then read the [Apps](https://devs.sia.storage/docs/core-concepts/apps) and [Indexers](https://devs.sia.storage/docs/core-concepts/indexers) concept pages.
+{% endhint %}
+
+## Why this matters: ownership without middlemen
+
+Many services marketed as "decentralized" still place a company-operated gateway or proxy between you and the network. Your files pass through that server, which makes it a bottleneck, a logging point, and a single party that can inspect, throttle, censor, or simply disappear — recreating the dependence on a central operator that decentralization is supposed to remove. Sia's architecture removes that middleman, by design.
+
+* **Your data never flows through a central server.** The SDK uploads and downloads encrypted shards **directly** to and from independent storage providers. The indexer coordinates *where* data lives and keeps it healthy, but it is never in the data path — it only ever handles encrypted metadata and the storage layout. There is no gateway that can see, meter, or gate your traffic.
+
+* **You hold the keys, so you own the data.** Encryption and erasure coding happen on your own device before anything leaves it, and the keys are derived from your recovery phrase. Neither the indexer nor the storage providers can read your files, your metadata, or even your filenames. Even the apps you use are walled off from one another — each app's key is derived from both your recovery phrase and its own identity, so one app can never read another app's data, even though both act on your behalf. Ownership is cryptographic — not a permission a provider grants you and can revoke.
+
+* **No single operator can hold your data hostage.** Each object is erasure-coded into redundant shards spread across many unrelated storage providers worldwide, and only a subset is needed to reconstruct it. No one provider — and no outage, business failure, or demand against a single party — can read your data or take it offline.
+
+* **You are never locked in.** The indexer is a swappable coordinator, not the owner of your data. You decide where your index lives — a hosted indexer like Sia Storage, or one you run yourself — and applications connect to whichever you choose. Because your data lives on contracts with storage providers and is recoverable with your recovery phrase, moving between indexers does not require downloading and reuploading your data or handing your data to a new gatekeeper.
+
+The result is storage that is genuinely distributed, private, and yours: no proxy in the middle, no operator that can read your data, and no provider that owns your access to it.
-## **Autopilot and your Allowance**
+## The Marketplace
+
+The Sia storage network is an open marketplace to connect consumers with providers for their data. The cost associated with this storage is competitively determined by storage providers and renters within the market. If providers discover that reducing prices allows them to secure more data for storage, they are inclined to do so. Similarly, if renters are willing to pay higher rates for storage with high-quality providers, those providers may opt to increase their prices.
+
+The storage price is denominated in Siacoins, and you will need Siacoins to form storage contracts and upload data. Storage providers have the autonomy to establish their prices, fostering a competitive marketplace where top-quality and dependable providers vie for storage contracts from those seeking to store data. Network pricing averages around **$3 per terabyte per month,** including 3x redundancy.
+
+## About contracts
+
+Storage contracts are one of the most essential features of the Sia network. They allow the entire Sia ecosystem to work trustlessly – they form blockchain-enforced agreements between you and your storage providers that are automatically resolved when each party meets their obligation. In other words, they let you form contracts with people you don't know to store your data.
+
+* **Storage providers** are responsible for data storage and receive compensation only after demonstrating successful storage for the agreed-upon period.
+* **Indexers** form and renew those contracts on your behalf, paying providers for the storage you use.
-By default, the Sia rentering software `renterd` runs with a module called `autopilot` enabled. `autopilot` is the software agent that automatically forms contracts based on your configured parameters. The most important parameter is your allowance; setting your allowance is the first thing you'll do when starting to store data on Sia.
+Contract management is automatic. When you use [Sia Storage](https://sia.storage) or run your own [`indexd`](setting-up-indexd/), the indexer forms contracts as needed when you upload and renews them before they expire, so your data stays available without manual intervention.
-The allowance tells Sia how much Siacoin you're willing to spend on storage space and makes sure more than this amount is not deducted from your wallet. Setting your allowance too low might mean that Sia can't upload all your data or cannot form contracts with enough hosts. You can raise or lower your allowance at any time.
+## Fees
-Setting your allowance happens before uploading files, and Sia automatically forms the contracts it needs with new hosts so that you can upload when you're ready. You might see multiple transactions hit your wallet right after setting your allowance – this is your Siacoins getting set aside with each host. Don't worry - you'll get whatever Siacoins you don't spend back at the end of the contract. With Sia, you only ever pay for what you use.
+As a renter, you pay for the cost of storing data on the network. There are also some other fees that you're responsible for, such as:
+
+* **Contract Formation Fees** – Creating storage contracts on the blockchain requires a transaction, and minimal fees are associated with this. Contract formation fees are one-time per contract and usually cost only a handful of Siacoins.
+* **Bandwidth Fees** – You pay for the bandwidth you use to upload or download files. This can also include wear and tear fees set by the storage provider to help pay for their physical storage devices.
{% hint style="info" %}
-#### **Getting Started with `renterd`**
+#### Getting Started
-Start storing data on Sia by downloading the official [renterd software](https://sia.tech/rent) and exploring our step-by-step [Setting up renterd](setting-up-renterd/) guide.
+For most people, the simplest way to start is the Sia Storage app with a free [Sia Storage](https://sia.storage) account (50 GB). To run the indexer yourself, see [Setting up indexd](setting-up-indexd/). Developers building applications can find the SDKs and guides in the [Sia Developer Portal](https://devs.sia.storage).
{% endhint %}
diff --git a/renting/renting-storage/README.md b/renting/renting-storage/README.md
index f34771cb..acaa2a04 100644
--- a/renting/renting-storage/README.md
+++ b/renting/renting-storage/README.md
@@ -14,7 +14,11 @@ layout:
# Storing Your Data
-Uploading files on `renterd` is remarkably straightforward, making it accessible even to those new to the Sia network. With just a few simple steps, you can securely store your files and data on Sia's decentralized cloud storage platform, where a network of hosts ensures the redundancy and reliability of your files. `renterd` provides an intuitive interface for effortlessly transferring your files to the Sia network.
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
+This guide walks you through uploading files with `renterd`. Your files are stored on Sia's decentralized storage network, where data is spread across a network of hosts for redundancy.
## Before you begin...
@@ -25,28 +29,28 @@ Uploading files on `renterd` is remarkably straightforward, making it accessible
## Uploading your files in renterd
{% hint style="warning" %}
-Uploading files and data with `renterd` is a very straightforward process, assuming you have completed all the steps of the `renterd` setup guide. Visit the [renterd](../setting-up-renterd/) guides to ensure everything is set up correctly before proceeding.
+Uploading files with `renterd` assumes you have completed all the steps of the `renterd` setup guide. Visit the [renterd](../setting-up-renterd/) guides to ensure everything is set up correctly before proceeding.
{% endhint %}
-1. Access the `rentered` UI from your local host address. Enter your `API password` you created to unlock `renterd`.
+1. Access the `renterd` UI from your local host address. Enter your `API password` you created to unlock `renterd`.
renterd Login UI
-2. Drag-and-drop files, or click the Upload Files button in the top right corner to begin uploading files. It's that simple!
+2. Drag-and-drop files, or click the Upload Files button in the top right corner to begin uploading files.
File upload UI
Once you've chosen the file(s) to upload, it will be classed as active upload; give it a few seconds.
{% hint style="success" %}
-Congratulations on successfully uploading your file(s) using `renterd`! Your data is now securely stored on the Sia network, benefiting from the reliability and resilience of decentralized storage.
+You have uploaded your file(s) using `renterd`. Your data is now stored on the Sia network.
{% endhint %}
## File processing
-When you begin to upload a file to Sia, it undergoes processing on your local machine to ensure optimal redundancy and security within the network. Initially, the file is divided into manageable chunks. Subsequently, each chunk undergoes a procedure that generates 30 distinct pieces, each encrypted before being dispatched to separate hosts. It's worth noting that only 10 of the 30 pieces are required for reconstructing a chunk, and no single host can access more than one piece.
+When you upload a file to Sia, it is processed on your local machine before being sent to the network. The file is divided into chunks. Each chunk is then split into 30 distinct pieces, each encrypted before being sent to a separate host. Only 10 of the 30 pieces are required to reconstruct a chunk, and no single host holds more than one piece.
-This arrangement ensures that up to 20 hosts could become disconnected from the network for each section of your original file, yet your data would remain safe and secure.
+This means up to 20 hosts can become disconnected from the network for each section of your original file, and your data remains recoverable.
{% hint style="info" %}
For the more technical readers, here is what happens behind the scenes:
diff --git a/renting/renting-storage/managing-your-files.md b/renting/renting-storage/managing-your-files.md
index b690f3b0..949c446b 100644
--- a/renting/renting-storage/managing-your-files.md
+++ b/renting/renting-storage/managing-your-files.md
@@ -14,9 +14,13 @@ layout:
# Managing your Files
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
## Maintaining your Data
-To ensure the constant availability of your data, you should perform a few crucial tasks periodically.
+To keep your data available, you should perform a few tasks periodically.
{% hint style="warning" %}
`renterd` **MUST** be running with your wallet unlocked for any actions to occur; therefore, it is advisable to open it at least once a month and let it run overnight to perform various essential housekeeping tasks.
@@ -44,13 +48,13 @@ Your contracts renew automatically when you open `renterd`.
### **Boosting file health**
-In `renterd` your files' health is quantified as a percentage, representing the number of available shards that comprise each file. Ideally, it would help if you strive for a perfect health rating of 100%, indicating that all 30 file shards are securely distributed among various hosts.
+In `renterd` your files' health is shown as a percentage, representing the number of available shards that make up each file. A health of 100% indicates that all 30 file shards are distributed among hosts.
File health check in renterd
-`renterd` incorporates an intelligent redundancy system that swiftly replicates any missing shards onto a new host in case one becomes unavailable during its next active check.
+`renterd` automatically replicates any missing shards onto a new host if one becomes unavailable during its next health check.
-Health assessments can only be conducted if `renterd` when it's actively running. To ensure the ongoing integrity of your data, it's advisable to periodically launch and operate Sia, allowing it to refresh the health status of your files and sustain their redundancy at optimal levels.
+Health checks only run while `renterd` is running. To maintain your data, periodically launch and run `renterd` so it can refresh the health status of your files and restore their redundancy.
## Downloading
diff --git a/renting/setting-up-indexd/README.md b/renting/setting-up-indexd/README.md
new file mode 100644
index 00000000..dc033e1d
--- /dev/null
+++ b/renting/setting-up-indexd/README.md
@@ -0,0 +1,43 @@
+---
+description: Run your own Sia indexer with indexd
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Setting up indexd
+
+`indexd` is the Sia Foundation's indexer daemon. It is the component that **manages contracts** with storage providers, tracks where your objects live on the network, monitors their health, and repairs data in the background. Applications connect to an indexer (through a [Sia Storage SDK](../about-renting.md)) to store and retrieve data without managing hosts or contracts themselves.
+
+{% hint style="success" %}
+**Most people don't need to run `indexd`.** [Sia Storage](https://sia.storage) is a hosted service that gives you **50 GB free** with nothing to install, run, or maintain — no server, no database, and no contracts to manage. Use Sia Storage unless you specifically want to operate your own indexer.
+{% endhint %}
+
+## Who should self-host?
+
+Most people, including developers building applications, should not run their own indexer. Point your application at [Sia Storage](https://sia.storage) during development instead. An application connects to a hosted indexer exactly the same way it connects to one you run yourself, so there is no need to operate one in order to build or test against it.
+
+The only reason to run your own `indexd` is to retain full control over the infrastructure your data and contracts depend on, rather than relying on a hosted service. This is a decision an individual user makes for their own data, not one an application should make on their behalf.
+
+## Before you start
+
+`indexd` is a server daemon, not a desktop application:
+
+* **There is no desktop app.** `indexd` is run from the command line or in a container.
+* **PostgreSQL 18 is required.** `indexd` stores its index in a PostgreSQL database. The [Docker](docker.md) guide runs PostgreSQL for you in a second container, so you don't have to install or manage a database separately.
+
+## Install
+
+* [**Docker**](docker.md) — runs `indexd` and PostgreSQL together with Docker Compose. This is the recommended way to self-host.
+
+{% hint style="info" %}
+You can also run the `indexd` binary directly against your own PostgreSQL server. The binaries are available on the [official website](https://sia.tech/software/indexd), and configuration options are documented in the [indexd repository](https://github.com/SiaFoundation/indexd).
+{% endhint %}
diff --git a/renting/setting-up-indexd/docker.md b/renting/setting-up-indexd/docker.md
new file mode 100644
index 00000000..8a358386
--- /dev/null
+++ b/renting/setting-up-indexd/docker.md
@@ -0,0 +1,193 @@
+---
+description: Run indexd and PostgreSQL together using Docker Compose
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Docker Compose
+
+This guide will walk you through setting up `indexd` using Docker Compose. Because `indexd` requires a PostgreSQL database, this is the **recommended** way to self-host: Docker Compose runs `indexd` and PostgreSQL together, so you don't have to install or manage a database separately.
+
+{% hint style="success" %}
+If you just want to store files, you don't need to run `indexd` at all — [Sia Storage](https://sia.storage) gives you 50 GB free with nothing to run.
+{% endhint %}
+
+---
+
+## Pre-requisites
+
+* **Software Requirements:** Before installing `indexd`, you will need to install [Docker](https://www.docker.com/get-started/).
+
+* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
+ - A quad-core CPU
+ - 8GB of RAM
+ - 256 GB SSD for `indexd` and its PostgreSQL database
+
+* **Network Access:** `indexd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
+
+{% hint style="info" %}
+PostgreSQL is provided automatically by the Compose file below, so you do **not** need to install it yourself for this method.
+{% endhint %}
+
+## Create the compose file
+
+Create a new file named `docker-compose.yml`. You can use the following as a template. The `postgres` service stores the `indexd` index, and the `indexd-data` volume holds the consensus data and config file.
+
+```yml
+services:
+ postgres:
+ image: postgres:18
+ restart: unless-stopped
+ shm_size: 128mb
+ environment:
+ POSTGRES_USER: indexd
+ POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+ POSTGRES_DB: indexd
+ volumes:
+ - postgres:/var/lib/postgresql
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+ interval: 5s
+ timeout: 5s
+ retries: 10
+ start_period: 10s
+
+ indexd:
+ depends_on:
+ postgres:
+ condition: service_healthy
+ image: ghcr.io/siafoundation/indexd:latest
+ restart: unless-stopped
+ ports:
+ - 127.0.0.1:9980:9980/tcp # admin UI and API (kept local)
+ - 9981:9981/tcp # public syncer
+ - 9982:9982/tcp # public application API
+ volumes:
+ - indexd-data:/data
+
+volumes:
+ indexd-data:
+ postgres:
+```
+
+{% hint style="warning" %}
+Be careful with port 9980 (the admin UI and API) as Docker will expose it publicly by default. It is recommended to bind it to `127.0.0.1` to prevent unauthorized access. Ports 9981 (syncer) and 9982 (application API) are meant to be reachable by the network and your applications.
+{% endhint %}
+
+## Set the database password
+
+Create a file named `.env` in the same directory as your `docker-compose.yml` and set a password for the PostgreSQL database:
+
+```sh
+POSTGRES_PASSWORD=your-secure-database-password
+```
+
+You will enter this same password during the `indexd` configuration step so the indexer can connect to the database.
+
+## Getting the `indexd` image
+
+To get the latest `indexd` image run the following command:
+```console
+docker compose pull
+```
+
+
+
+## Generate a recovery phrase
+
+`indexd` uses a wallet to pay for storage contracts. If you don't already have a recovery phrase, generate one:
+
+```console
+docker compose run --rm indexd seed
+```
+
+{% hint style="warning" %}
+Write your recovery phrase down and store it somewhere safe. It controls the wallet that funds your contracts and cannot be recovered if lost.
+{% endhint %}
+
+## Configuring `indexd`
+
+Now launch the interactive configuration wizard:
+
+```console
+docker compose run --rm -it indexd config
+```
+
+The wizard will ask you for:
+
+* Your **wallet recovery phrase** (use the one you generated above).
+* An **admin password** used to unlock the `indexd` admin UI.
+* A **database password** — enter the same value you set in `.env`.
+* An **application API advertise URL** — the public URL applications will use to reach this indexer.
+
+When asked whether to configure **advanced settings**, answer `yes` and set the database connection so `indexd` can reach the PostgreSQL container:
+
+| Setting | Value |
+|---------|-------|
+| Database address | `postgres:5432` |
+| Database user | `indexd` |
+| Database name | `indexd` |
+| SSL mode | `disable` |
+
+
+
+## Running `indexd`
+
+Now that you have `indexd` configured, start the services:
+
+```console
+docker compose up -d
+```
+
+
+
+Once `indexd` has started, you can access the admin UI by opening your browser and going to [http://localhost:9980](http://localhost:9980/).
+
+
+
+{% hint style="success" %}
+`indexd` is now set up.
+{% endhint %}
+
+## Fund your wallet
+
+`indexd` uses a built-in wallet to pay storage providers for the contracts it forms on your behalf, so it needs Siacoin (SC) before it can store any data. After signing in, the **Welcome to Sia** checklist in the admin UI walks you through the remaining setup, including funding your wallet.
+
+Open the **Wallet** section of the UI, copy your receiving address, and send Siacoin to it from an exchange or another wallet. See [Transferring Siacoins](../transferring-siacoins.md) for the full send and receive flow.
+
+Once your wallet shows a confirmed balance, `indexd` can begin forming contracts and storing data.
+
+## Checking the container status
+
+To check the status of the containers run:
+```console
+docker compose ps
+```
+
+## Checking the logs
+
+To check the `indexd` logs run:
+```console
+docker compose logs indexd
+```
+
+## Upgrading `indexd`
+
+New versions of `indexd` are released regularly and contain bug fixes and performance improvements. To upgrade to the newest version, run the following:
+
+```console
+docker compose pull && docker compose up -d
+```
+
+{% hint style="success" %}
+`indexd` is now updated to the latest version.
+{% endhint %}
diff --git a/renting/setting-up-renterd/README.md b/renting/setting-up-renterd/README.md
index 0683d9fb..f1541599 100644
--- a/renting/setting-up-renterd/README.md
+++ b/renting/setting-up-renterd/README.md
@@ -1,2 +1,15 @@
# Setting up renterd
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
+`renterd` is the original all-in-one renter daemon, bundling a wallet, contract management, and an upload/download UI into one program. These guides walk you through installing and configuring it.
+
+Choose an install method:
+
+- [macOS](macos.md) — installed with Homebrew.
+- [Linux](linux/) — apt package (Debian or Ubuntu) or a manual binary.
+- [Docker](docker.md)
+- [Windows](windows.md) — desktop app.
+
diff --git a/renting/setting-up-renterd/docker.md b/renting/setting-up-renterd/docker.md
index 39e141dc..c5f3b413 100644
--- a/renting/setting-up-renterd/docker.md
+++ b/renting/setting-up-renterd/docker.md
@@ -15,6 +15,10 @@ layout:
# Docker Compose
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
This guide will walk you through setting up `renterd` using Docker compose. At the end of this guide, you should have the following:
* Installed Sia `renterd` software
@@ -99,7 +103,7 @@ Finally, you will be asked if you want to configure advanced settings for `rente
## Running `renterd`
-Now that you have `renterd` successfully installed and configured, it is time to run it. Use the following command to start `renterd`:
+Now that you have `renterd` installed and configured, use the following command to start it:
```console
docker compose up -d
@@ -107,14 +111,12 @@ docker compose up -d
-
-
Once `renterd` has successfully started, you can access the web UI by opening your browser and going to [http://localhost:9980](http://localhost:9980/).
{% hint style="success" %}
-Congratulations, you have successfully set up `renterd`.
+You have set up `renterd`.
{% endhint %}
## Checking the container status
@@ -139,9 +141,9 @@ docker compose logs renterd
## Upgrading `renterd`
-It is essential to keep your host up to date. New versions of `renterd` are released regularly and contain bug fixes and performance improvements.
+New versions of `renterd` are released regularly and contain bug fixes and performance improvements.
-To upgrade your `renterd` to the newest version, simply run the following command:
+To upgrade your `renterd` to the newest version, run the following command:
```console
docker compose pull && docker compose up -d
@@ -150,5 +152,5 @@ docker compose pull && docker compose up -d
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `renterd`!
+Your version of `renterd` has been updated.
{% endhint %}
diff --git a/renting/setting-up-renterd/linux/README.md b/renting/setting-up-renterd/linux/README.md
index e2a38530..4f50243b 100644
--- a/renting/setting-up-renterd/linux/README.md
+++ b/renting/setting-up-renterd/linux/README.md
@@ -14,7 +14,11 @@ layout:
# Linux
-`renterd` is designed to be run as a background service to store and retrieve data on the Sia network. This guide will walk you through the process of installing and configuring `renterd` on a Linux machine. Linux is the recommended operating system for running `renterd` because of its stability. We recommend using a Debian-based distribution, such as Ubuntu or Debian, but `renterd` should work on any modern Linux distribution. The setup guides in these docs are primarily focused on installing using `apt`, but `renterd` can also be installed as a binary manually or run in a Docker container.
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
+`renterd` runs as a background service to store and retrieve data on the Sia network. This guide will walk you through the process of installing and configuring `renterd` on a Linux machine. Linux is the recommended operating system for running `renterd` because of its stability. We recommend using a Debian-based distribution, such as Ubuntu or Debian, but `renterd` should work on any modern Linux distribution. The setup guides in these docs are primarily focused on installing using `apt`, but `renterd` can also be installed as a binary manually or run in a Docker container.
- [Debian](debian.md)
- [Ubuntu](ubuntu.md)
diff --git a/renting/setting-up-renterd/linux/debian.md b/renting/setting-up-renterd/linux/debian.md
index 4921d13e..a4c9e95f 100644
--- a/renting/setting-up-renterd/linux/debian.md
+++ b/renting/setting-up-renterd/linux/debian.md
@@ -14,6 +14,10 @@ layout:
# Debian
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
This guide will walk you through setting up `renterd` on Linux. At the end of this guide, you should have the following:
* Installed the `renterd` software
@@ -149,7 +153,7 @@ sudo systemctl start renterd
Now that you have `renterd` installed and running, you can start using it to store and retrieve data on the Sia network. You can access the web interface by navigating to [http://127.0.0.1:9980](http://127.0.0.1:9980) in your web browser. If you installed `renterd` on a remote machine or a server, you will need to create an SSH tunnel to access the web interface.
-
+
- [About Storing Your Data](../../about-renting.md)
- [Transferring Siacoins](../../transferring-siacoins.md)
diff --git a/renting/setting-up-renterd/linux/other.md b/renting/setting-up-renterd/linux/other.md
index 318523b8..b46f3cd1 100644
--- a/renting/setting-up-renterd/linux/other.md
+++ b/renting/setting-up-renterd/linux/other.md
@@ -12,7 +12,11 @@ layout:
visible: true
---
-# Linux
+# Other Linux Distributions
+
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
This guide will walk you through setting up `renterd` on Linux. At the end of this guide, you should have the following:
@@ -76,31 +80,13 @@ sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_arm64.zip
```
{% endtab %}
-
-{% tab title="Zen AMD64" %}
-```console
-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
-```
-{% endtab %}
-
-{% tab title="Zen ARM64" %}
-```console
-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
-```
-{% endtab %}
{% endtabs %}
{% hint style="info" %}
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.
{% endhint %}
-
+
---
@@ -108,25 +94,15 @@ You’ll be prompted to authorize this action by providing your system password.
`renterd` uses BIP-39 12-word recovery phrases. To generate a new wallet recovery phrase, run the following command:
-{% tabs %}
-{% tab title="Mainnet" %}
```console
renterd seed
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-renterd_zen seed
-```
-{% endtab %}
-{% endtabs %}
{% hint style="warning" %}
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.
{% endhint %}
-
+
---
@@ -136,68 +112,31 @@ Now that you have a recovery phrase, we will create a new system user and `syste
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.
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo useradd -M renterd &&\
sudo usermod -L renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo useradd -M renterd_zen &&\
-sudo usermod -L renterd_zen
-```
-{% endtab %}
-{% endtabs %}
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:
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo mkdir /var/lib/renterd &&\
sudo chown renterd:renterd /var/lib/renterd &&\
sudo chmod o-rwx /var/lib/renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo mkdir /var/lib/renterd_zen &&\
-sudo chown renterd_zen:renterd_zen /var/lib/renterd_zen &&\
-sudo chmod o-rwx /var/lib/renterd_zen
-```
-{% endtab %}
-{% endtabs %}
---
## Configure your `renterd.yml` file
-To begin, create a file name `renterd.yml` file under `/var/lib/renterd/`
+To begin, create a `renterd.yml` file under `/var/lib/renterd/`
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo nano /var/lib/renterd/renterd.yml
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo nano /var/lib/renterd_zen/renterd.yml
-```
-{% endtab %}
-{% endtabs %}
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.
-{% hint style="warning" %}
-`your_access_key` can be anywhere from 16 to 128 characters long, and `your_private_key` must be exactly 40 characters long.
-{% endhint %}
-
```yaml
seed: your seed phrase goes here
http:
@@ -208,30 +147,22 @@ autopilot:
Once you have added your recovery phrase and password, save the file with `ctrl+s` and exit with `ctrl+x`.
+{% hint style="info" %}
+To use the Zen testnet instead of mainnet, add `network: zen` to your `renterd.yml`. The same `renterd` binary serves both networks, and the web UI stays on port 9980.
+{% endhint %}
+
---
## Setting up a systemd service
Now we can create a new system service to run `renterd` on startup:
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo nano /etc/systemd/system/renterd.service
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo nano /etc/systemd/system/renterd_zen.service
-```
-{% endtab %}
-{% endtabs %}
Once the editor loads, copy and paste the following into it.
-{% tabs %}
-{% tab title="Mainnet" %}
```toml
[Unit]
Description=renterd
@@ -249,28 +180,6 @@ User=renterd
WantedBy=multi-user.target
Alias=renterd.service
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```toml
-[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
-```
-{% endtab %}
-{% endtabs %}
You can now save the file with `ctrl+s` and exit with `ctrl+x`.
@@ -280,21 +189,10 @@ You can now save the file with `ctrl+s` and exit with `ctrl+x`.
Now it is time to start the service
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo systemctl start renterd &&\
sudo systemctl enable renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo systemctl start renterd_zen &&\
-sudo systemctl enable renterd_zen
-```
-{% endtab %}
-{% endtabs %}
{% hint style="warning" %}
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.
@@ -302,19 +200,9 @@ On newer versions of Linux (Ubuntu 22.04+), `sudo systemctl enable renterd` may
Your `renterd` service should now be running. You can check the status of the service by running the following command:
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo systemctl status renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo systemctl status renterd_zen
-```
-{% endtab %}
-{% endtabs %}
If the service was set up correctly, it should say “active (running).”
@@ -322,20 +210,16 @@ 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.
{% endhint %}
-
+
You can now access the Sia network using the `renterd` web UI by opening a browser and going to [http://localhost:9980](http://localhost:9980/).
-{% hint style="warning" %}
-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](http://localhost:9880).
-{% endhint %}
-
-
+
Enter the API `password` you created in your `renterd.yml` to unlock the `renterd` web UI.
{% hint style="success" %}
-Congratulations, you have successfully set up `renterd`.
+You have set up `renterd`.
{% endhint %}
---
@@ -347,19 +231,9 @@ New versions of `renterd` are released regularly and contain bug fixes and perfo
**To update:**
1. Stop the `renterd` system service.
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo systemctl stop renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo systemctl stop renterd_zen
-```
-{% endtab %}
-{% endtabs %}
2. Download and install the latest version of `renterd`.
@@ -385,24 +259,6 @@ sudo mv renterd /usr/local/bin/renterd &&\
rm -fr renterd_linux_arm64.zip
```
{% endtab %}
-
-{% tab title="Zen AMD64" %}
-```console
-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
-```
-{% endtab %}
-
-{% tab title="Zen ARM64" %}
-```console
-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
-```
-{% endtab %}
{% endtabs %}
{% hint style="info" %}
@@ -410,41 +266,21 @@ You'll be prompted to authorize this action by providing your system password. T
{% endhint %}
3. Restart the `renterd` system service.
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo systemctl start renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo systemctl start renterd_zen
-```
-{% endtab %}
-{% endtabs %}
4. Verify the `renterd` service is running correctly.
-{% tabs %}
-{% tab title="Mainnet" %}
```console
sudo systemctl status renterd
```
-{% endtab %}
-
-{% tab title="Zen Testnet" %}
-```console
-sudo systemctl status renterd_zen
-```
-{% endtab %}
-{% endtabs %}
{% hint style="warning" %}
If, for some reason, the `renterd` service will not start, use the command `journalctl -fu renterd` to view the console output for more information.
{% endhint %}
-
+
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `renterd`!
+Your version of `renterd` has been updated.
{% endhint %}
diff --git a/renting/setting-up-renterd/linux/ubuntu.md b/renting/setting-up-renterd/linux/ubuntu.md
index d9744595..3274eb8d 100644
--- a/renting/setting-up-renterd/linux/ubuntu.md
+++ b/renting/setting-up-renterd/linux/ubuntu.md
@@ -14,6 +14,10 @@ layout:
# Ubuntu
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
This guide will walk you through setting up `renterd` on Linux. At the end of this guide, you should have the following:
* Installed the `renterd` software
@@ -67,7 +71,7 @@ sudo apt update
sudo apt install renterd
```
-
+
**3. Verify `renterd` was installed successfully**
@@ -139,7 +143,7 @@ sudo systemctl start renterd
Now that you have `renterd` installed and running, you can start using it to store and retrieve data on the Sia network. You can access the web interface by navigating to [http://127.0.0.1:9980](http://127.0.0.1:9980) in your web browser. If you installed `renterd` on a remote machine or a server, you will need to create an SSH tunnel to access the web interface.
-
+
- [About Storing Your Data](../../about-renting.md)
- [Transferring Siacoins](../../transferring-siacoins.md)
diff --git a/renting/setting-up-renterd/macos.md b/renting/setting-up-renterd/macos.md
index ff03e220..35fdba55 100644
--- a/renting/setting-up-renterd/macos.md
+++ b/renting/setting-up-renterd/macos.md
@@ -14,6 +14,10 @@ layout:
# macOS
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
This guide will walk you through setting up `renterd` on macOS. At the end of this guide, you should have:
* Installed Sia `renterd` software
@@ -97,10 +101,6 @@ Next, you will be asked to configure the S3 address. If you would like to use so
-You will now be asked to generate a new key pair. Type `auto` and hit enter to have a key pair generated automatically for you.
-
-
-
Finally, you will be asked if you would like to configure `renterd`'s advanced settings. Type `no` and hit enter to exit the configuration wizard.
@@ -123,7 +123,7 @@ You can now access the Sia network using the `renterd` web UI by opening a brows
{% hint style="success" %}
-Congratulations, you have successfully set up `renterd`.
+You have set up `renterd`.
{% endhint %}
---
@@ -149,5 +149,5 @@ renterd version
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `renterd`!
+Your version of `renterd` has been updated.
{% endhint %}
diff --git a/renting/setting-up-renterd/windows.md b/renting/setting-up-renterd/windows.md
index 4bddebea..ef3762a2 100644
--- a/renting/setting-up-renterd/windows.md
+++ b/renting/setting-up-renterd/windows.md
@@ -14,7 +14,11 @@ layout:
# Windows Desktop App: `renterd`
-The `renterd` desktop app provides a user-friendly web UI to start storing data on the Sia network. By the end of this guide, you will have:
+{% hint style="info" %}
+**`renterd` is no longer the preferred way to store data on Sia.** For most users, [Sia Storage](https://sia.storage) (50 GB free, nothing to run) or a self-hosted [`indexd`](../setting-up-indexd/) is a better starting point. `renterd` still works, and these guides remain for existing users.
+{% endhint %}
+
+The `renterd` desktop app provides a web UI to start storing data on the Sia network. By the end of this guide, you will have:
* Installed the `renterd` desktop application.
* Created a `renterd` wallet
@@ -38,7 +42,7 @@ To ensure proper functionality, we are recommending a minimum of 8 GB RAM. This
## Download
-1. Go to [Sia Software Downloads](https://sia.tech/software-downloads). Here you can find the latest software downloads for all our daemons.
+1. Go to [Sia Software Downloads](https://sia.tech/software-downloads). Here you can find the latest downloads for all Sia daemons.
@@ -58,7 +62,7 @@ After downloading the `renterd` desktop application:
1. **Install the app:** Double-click the installer (e.g., `renterd..Setup.exe`) and follow the prompts. The app installs to the default location.
2. **Launch the app:** After installation, you can delete the installer, and launch `renterd` from the Start Menu like any other program.
-3. **Initial setup *(first-time users only)*:** On first launch, the Welcome to `renterd` window will guide you to generate a recovery phrase (which you can copy and lock) and set a password to access web UI.
+3. **Initial setup *(first-time users only)*:** On first launch, the Welcome to `renterd` window prompts you to generate a recovery phrase (which you can copy and lock) and set a password to access the web UI.
@@ -71,15 +75,15 @@ When you first run `renterd`, Windows Security may ask to allow public and priv
{% hint style="success" %}
-**Success!** `renterd` is now running on your Windows system, and you’re ready to start storing your data on the Sia network.
+`renterd` is now running on your Windows system, and you can start storing your data on the Sia network.
{% endhint %}
## Configure
-You can customize `renterd` through the desktop app, which provides full control over all available settings, from wallet security to network and S3 configurations.
+You can configure `renterd` through the desktop app, which exposes its settings, from wallet security to network and S3 configurations.
-On **Windows**, you can access the `renterd` configurations by going to the taskbar, expanding the up arrow to see hidden icons, and double-clicking the `renterd` app. This will open the configuration window and let you customize its behavior.
+On **Windows**, you can access the `renterd` configurations by going to the taskbar, expanding the up arrow to see hidden icons, and double-clicking the `renterd` app. This opens the configuration window.
@@ -102,15 +106,15 @@ There are several configurable settings in `renterd`. Below is a breakdown of wh
Always **save and restart daemon** after making configuration changes to ensure they are applied.
{% endhint %}
-You can monitor your node’s activity and track changes by checking the logs. These provide detailed information about the system, network connections, API endpoints, S3 interface, and autopilot operations, helping you understand what your node is doing at any given time.
+You can monitor your node’s activity by checking the logs. These provide information about the system, network connections, API endpoints, S3 interface, and autopilot operations.
## Update
-`renterd` updates regularly with bug fixes, performance improvements, and new features. Updating your node ensures stability and compatibility with the Sia network.
+`renterd` updates regularly with bug fixes, performance improvements, and new features. Updating your node keeps it compatible with the Sia network.
-On Windows, the app downloads updates automatically and notifies you when they’re ready. Simply restart the app to run the latest version.
+On Windows, the app downloads updates automatically and notifies you when they’re ready. Restart the app to run the latest version.
{% hint style="info" %}
You can always check for the version of the software at the bottom of the app interface.
diff --git a/renting/transferring-siacoins.md b/renting/transferring-siacoins.md
index e631794d..b17e469d 100644
--- a/renting/transferring-siacoins.md
+++ b/renting/transferring-siacoins.md
@@ -14,7 +14,11 @@ layout:
# Transferring Siacoins
-Whether you're sending Siacoins to an exchange or receiving from a friend, `renterd` facilitates the transfer of Siacoins (SC) and is easily achieved via the UI.
+Whether you're funding your node's wallet or sending Siacoins to an exchange, you can transfer Siacoins (SC) through the UI. Funding the wallet is a required step when self-hosting [`indexd`](setting-up-indexd/), whose wallet pays storage providers for the contracts it forms on your behalf.
+
+{% hint style="info" %}
+The screenshots below show the `renterd` UI, but the wallet send and receive flow is the same in the `indexd` and `walletd` UIs.
+{% endhint %}
## Sending Siacoins
diff --git a/renting/using-sia-storage.md b/renting/using-sia-storage.md
new file mode 100644
index 00000000..c6ba09bf
--- /dev/null
+++ b/renting/using-sia-storage.md
@@ -0,0 +1,96 @@
+---
+description: >-
+ Get started with Sia Storage — hosted, end-to-end encrypted, decentralized
+ storage with 50 GB free and nothing to run.
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Using Sia Storage
+
+[Sia Storage](https://sia.storage) is a hosted **indexer** — the managed backend for storing data on Sia. It forms and manages storage contracts and keeps your data healthy for you, so there's no server, database, or contracts for you to run. To actually store and retrieve files, you point a **client** — the Sia Storage app or `s3d` — at your Sia Storage account.
+
+Your files are still encrypted on your own device and erasure-coded across independent storage providers, as described in [About Storing Your Data](about-renting.md); Sia Storage only ever handles encrypted metadata, never your keys or file contents.
+
+{% hint style="success" %}
+**For almost everyone, this is the right place to start.** A Sia Storage account gives you **50 GB free**, with no infrastructure to run. You only need to self-host an [indexer](setting-up-indexd/) if you specifically want to control the backend yourself.
+{% endhint %}
+
+## Why Sia Storage
+
+* **Private.** Files are encrypted on your device before they leave it, with keys derived from your recovery phrase. Neither Sia Storage nor the storage providers can read your data.
+* **Decentralized.** Your data is stored across many independent storage providers, not in one company's data center, so no single operator or outage can read it or take it offline.
+* **No infrastructure to run.** Sia Storage operates the indexer and manages contracts for you, so you can use the Sia network without running a server or database.
+
+## Store your first file
+
+Getting started takes three steps: sign up, install the app, and upload.
+
+### 1. Create your Sia Storage account
+
+Go to [sia.storage](https://sia.storage) and select **Get Started** to create a free account. The free plan includes **50 GB of storage**, up to **3 connected apps**, and transfer speeds up to 524 Mbps — with no Siacoin to buy and no server to run.
+
+
+
+### 2. Install the Sia Storage app
+
+The app is how you upload and browse your files. Install it for your device:
+
+* **iOS** — [App Store](https://apps.apple.com/us/app/sia-storage/id6753593109)
+* **Android** — [Google Play](https://play.google.com/store/apps/details?id=sia.storage)
+* **Desktop (macOS, Windows, Linux)** — download from [sia.storage](https://sia.storage)
+
+### 3. Connect the app and set your recovery phrase
+
+The first time you open the app, connect it to your Sia Storage account:
+
+1. Tap **Sign In** and approve the connection request on sia.storage. This authorizes the app to use your account. If you don't have an account yet, one is created for you.
+2. Back in the app, enter your **recovery phrase** — the 12-word secret that derives the keys used to encrypt your files. If you don't already have one, the app generates a new one for you.
+
+Once connected, the app is ready to store files. Your encryption keys stay on your device, so neither Sia Storage nor the storage providers can read your data.
+
+
+
+
+
+{% hint style="danger" %}
+**Write down your recovery phrase and store it somewhere safe.** It derives the keys that encrypt your files and identify you to your account. If you lose it, your files cannot be decrypted or recovered; if someone else gets it, they can access your data. Never share it, and don't rely on the app alone to keep it. See [Your Sia Seed](../get-started-with-sia/the-importance-of-your-seed.md) for more.
+{% endhint %}
+
+### 4. Upload a file
+
+Choose **Upload** in the app (or drag and drop on desktop) and pick a file. The app encrypts it on your device, splits it into redundant pieces, and distributes those across storage providers. When it finishes, the file appears in your list.
+
+### 5. Access your files
+
+Your files are available from any device where you sign in to your account. Select a file to download it — it's retrieved from the storage providers and decrypted on your device.
+
+
+
+{% hint style="success" %}
+Your file is now stored on the decentralized Sia network — encrypted, redundant, and under your control.
+{% endhint %}
+
+## Other ways to use it
+
+* **S3-compatible access.** [`s3d`](https://github.com/SiaFoundation/s3d) is a gateway that exposes an S3-compatible API backed by your Sia Storage account, so existing S3 tools such as Rclone and Cyberduck can use Sia — see our [S3 integration guides](../sia-integrations/s3-integrations/).
+* **Build your own app.** Use the [Sia Storage SDKs](https://devs.sia.storage) to store and retrieve data from your own software — see [For developers](#for-developers) below.
+
+Paid plans are available at [sia.storage](https://sia.storage) if you need more storage or connected apps.
+
+## For developers
+
+Sia Storage is also a hosted indexer your applications can build on. If you're building software on Sia, the [Sia Developer Portal](https://devs.sia.storage) covers the SDKs, the app identity model, and a [quickstart](https://devs.sia.storage/docs/quickstart) for uploading and downloading objects.
+
+{% hint style="info" %}
+Your application should let users choose where their data is stored rather than locking them to a single indexer. See [About Storing Your Data](about-renting.md#building-apps) for how applications, the SDK, and the indexer fit together.
+{% endhint %}
diff --git a/sia-integrations/brand-guidelines-for-sia-in-your-project-or-site-wip.md b/sia-integrations/brand-guidelines-for-sia-in-your-project-or-site-wip.md
deleted file mode 100644
index d18f8caa..00000000
--- a/sia-integrations/brand-guidelines-for-sia-in-your-project-or-site-wip.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# Brand guidelines for Sia in your project or site
-
-Community and third-party \(non-core\) projects are an essential part of the Sia ecosystem. They expand the use-cases for Sia, and improve the network with solutions we aren’t actively working on.
-
-We want users to be able to distinguish between core and non-core projects for a number of reasons:
-
-* Non-core projects typically involve a bit of centralization, and that’s ok. Users need choice, and centralization provides features that are much easier to implement than can be done on Sia.
-* People might confuse your project with something built by the core team, and we want to make sure users know who to go to for help.
-* You worked hard on your project, and we want it to stand out!
-
-In an effort to promote these goals, please use the following as guidelines when developing your brand.
-
-## Official Sia assets
-
-[Get them here](https://gitlab.com/NebulousLabs/Sia/-/tree/master/doc/assets/community/sia). It includes our logo and wordmark in a variety of high-quality formats, as well as the built with Sia logo for third-party projects.
-
-## `built with Sia`
-
-
-
-If you are building a project featuring Sia, use the `built with Sia` logo to showcase your integration. You can drop this in the app, website, or anywhere else that makes sense.
-
-## Naming your project
-
-You have a lot of freedom here. Feel free to use the word “Sia” however you want in your project, with two exceptions:
-
-* Don’t call your project “Sia”. Because that’s our name.
-* Don't use the term “Sia” and then a generic term that directly relates to our business like “Cloud”, “Storage”, or "Backup".
-
-Current examples of good naming in the community are: SiaStats, Siasync, SiaWiki, and Siamining. You know it's about Sia, and get a good idea of what specifically the project might focus on.
-
-Just remember, if you’re trying to make a play on words, we pronounce Sia like “sigh-uh” and not “see-ya”.
-
-You can also create a wonderfully custom name that represents you or your work. Some examples are projects like Pixeldrain, Filebase, and roadie.
-
-## Logo and Wordmark
-
-We’re a little stricter on this one. We own the trademark in the US for both the Sia logo and wordmark:
-
-
-
-We’d prefer that your project not use the Sia logo or wordmark directly in any capacity, but you can style on it as long as a normal user wouldn’t confuse it for the real thing.
-
-A good example of this is SiaStats:
-
-
-
-The logo is similar, but is easily differentiated from the Sia logo by both the color and the design using a line graph in the center. Plus, it perfectly represents what the site is about - Sia and stats!
-
-## Color
-
-Sia uses a number of colors.
-
-
-
-If you use the exact Sia logo or wordmark in any way, like to represent the fact that you integrate with Sia on your site, the image should either use our green or one of these grays. In other words, don't use our exact logo or wordmark and change the color to match your color scheme.
-
-When designing your own logo, feel free to draw from our color palette or create your own.
-
-We can't wait to see what you build! Be sure you let us know in [Discord](https://discord.gg/sia).
-
diff --git a/sia-integrations/s3-integrations/jellyfin.md b/sia-integrations/s3-integrations/jellyfin.md
index fec06862..b5d83223 100644
--- a/sia-integrations/s3-integrations/jellyfin.md
+++ b/sia-integrations/s3-integrations/jellyfin.md
@@ -18,7 +18,7 @@ layout:
## What is `Jellyfin`?
-Jellyfin stands out as a free, open-source media server, offering a compelling alternative to proprietary platforms like Emby and Plex. It’s designed to give you complete control over organizing, managing, and streaming your media collection, which includes movies, TV shows, music, and photos. Its client/server model ensures cross-platform compatibility, enabling access to various devices, including desktops, smartphones, and smart TVs. The main allure of setting up Jellyfin is the autonomy it offers: you have complete control over your media, free from hidden fees or data tracking. Its user-friendly interface and robust community support make it highly customizable and continuously evolving. Jellyfin is ideal for creating a personal media hub, akin to having your own private Netflix, where your entire media library is organized and easily streamable to your chosen devices anywhere in the world. This combination of features makes Jellyfin not just a media server but a customizable, privacy-respecting solution that adapts to your growing media needs.
+Jellyfin is a free, open-source media server and an alternative to proprietary platforms like Emby and Plex. It lets you organize, manage, and stream your media collection, including movies, TV shows, music, and photos. Its client/server model works across platforms, including desktops, smartphones, and smart TVs. You keep control over your media, with no fees or data tracking.
## Recommended System Requirements:
@@ -28,7 +28,7 @@ Jellyfin stands out as a free, open-source media server, offering a compelling a
* **Storage:** SSD for the operating system and applications, with additional HDD or SSD storage for cached media files.
-* **Network:** Stable, high-speed internet connection for effective streaming and data transfers.
+* **Network:** Stable, high-speed internet connection for streaming and data transfers.
* **Operating System:**
@@ -53,7 +53,7 @@ Install rclone and configure a new S3 remote using `renterd` for your storage ba
## Step 3: Upload media
-Once your `renterd` remote has been mounted on your system, you can begin uploading media. For the best experience, following the Jellyfin naming and sorting conventions is recommended. Doing so will help Jellyfin automatically obtain detailed metadata from various online databases. This includes cover art, media description, date, rating, related media, etc.
+Once your `renterd` remote has been mounted on your system, you can begin uploading media. Following the Jellyfin naming and sorting conventions is recommended. Doing so will help Jellyfin automatically obtain metadata from online databases, including cover art, media description, date, rating, related media, etc.
Below is an example of a properly structured file system following Jellyfin’s [TV Shows](https://jellyfin.org/docs/general/server/media/shows) and [Movies](https://jellyfin.org/docs/general/server/media/movies/) standards.
@@ -108,12 +108,12 @@ Select the `Language` and `Country` you would like to use as the default for dow
Configure Remote Access to your Server. If you are planning on accessing your libraries from another device on your network, you will need to have `Allow remote connections to this server` selected. Click “Next” when ready.
{% hint style="warning" %}
-If you would like to access your Jellyfin libraries from outside your network, you should only do so using a secure `HTTPS` connection. This can be easily set up using [Caddy](https://caddyserver.com/).
+If you would like to access your Jellyfin libraries from outside your network, you should only do so using a secure `HTTPS` connection. This can be set up using [Caddy](https://caddyserver.com/).
{% endhint %}
-Congratulations! You have completed setting up your Jellyfin server. You can now click “Finish” and log in using the account you created initially.
+You have completed setting up your Jellyfin server. You can now click “Finish” and log in using the account you created initially.
@@ -143,6 +143,6 @@ Next, enter your `User` name and `Password`, then click "Sign In.
## All done.
-Congratulations! You have successfully set up Jellyfin to stream your media collection from the Sia network.
+You have set up Jellyfin to stream your media collection from the Sia network.
\ No newline at end of file
diff --git a/sia-integrations/s3-integrations/nextcloud.md b/sia-integrations/s3-integrations/nextcloud.md
index a68f9c09..8bcca6a0 100644
--- a/sia-integrations/s3-integrations/nextcloud.md
+++ b/sia-integrations/s3-integrations/nextcloud.md
@@ -18,7 +18,7 @@ layout:
## What is `Nextcloud`?
-Nextcloud is an open-source content collaboration platform. It’s like your own Cloud service that runs on your own hardware. You can use it for storing and sharing files through a web interface, mobile app, or desktop client, and even to collaborate with others or as a communication platform. There is almost no limit to what it can do with its open plugin store.
+Nextcloud is an open-source content collaboration platform. It’s like your own Cloud service that runs on your own hardware. You can use it for storing and sharing files through a web interface, mobile app, or desktop client, and even to collaborate with others or as a communication platform. Its open plugin store adds further functionality.
## Step 1: Install `renterd` and configure S3
This guide requires that you have a working installation of `renterd`. If you have not already installed `renterd`, you will need to do so before continuing.
@@ -66,7 +66,7 @@ Select “Amazon S3” and give your folder a friendly name like “Sia”. For
## All done.
-Congratulations! You successfully configured Sia as a backend for your `Nextcloud` instance. If you click the “Files” tab on the top and then “External storage” in the menu on the left, you should see the folder as shown below.
+You have configured Sia as a backend for your `Nextcloud` instance. If you click the “Files” tab on the top and then “External storage” in the menu on the left, you should see the folder as shown below.
diff --git a/sia-integrations/s3-integrations/rclone.md b/sia-integrations/s3-integrations/rclone.md
index 4d633500..4a771342 100644
--- a/sia-integrations/s3-integrations/rclone.md
+++ b/sia-integrations/s3-integrations/rclone.md
@@ -19,7 +19,7 @@ layout:
## What is rclone?
-Rclone is a command-line program to manage files on cloud storage. Rclone is very feature-rich and integrates with dozens of cloud storage providers, including any S3-compatible object stores like Sia `renterd`.
+Rclone is a command-line program to manage files on cloud storage. It integrates with dozens of cloud storage providers, including any S3-compatible object stores like Sia `renterd`.
> Users call rclone _"The Swiss army knife of cloud storage"_, and _"Technology indistinguishable from magic"_.
diff --git a/sia-integrations/using-the-sia-ledger-nano-app-sia-central.md b/sia-integrations/using-the-sia-ledger-nano-app-sia-central.md
index 732ff4c3..66a82a08 100644
--- a/sia-integrations/using-the-sia-ledger-nano-app-sia-central.md
+++ b/sia-integrations/using-the-sia-ledger-nano-app-sia-central.md
@@ -2,9 +2,9 @@
## What is a Ledger Nano?
-The Ledger Nano X and Ledger Nano S are hardware wallets created by Ledger. A hardware wallet stores the private keys to cryptocurrency on a separate device, making it much harder for malicious parties to steal them. In fact, the private keys never leave the hardware wallet, so they will remain secure even if the device is connected to a compromised computer. As long as you follow best practices when using your hardware wallet, it is virtually impossible for an attacker to steal your funds.
+The Ledger Nano X and Ledger Nano S are hardware wallets created by Ledger. A hardware wallet stores the private keys to cryptocurrency on a separate device, making it harder for malicious parties to steal them. The private keys never leave the hardware wallet, so they remain secure even if the device is connected to a compromised computer. As long as you follow best practices when using your hardware wallet, it is very difficult for an attacker to steal your funds.
-Hardware wallets are an important part of the crypto ecosystem, and they're one of the best ways to personally secure your coins. We're happy to be working with Ledger to offer our official Sia app for use on both the Ledger Nano X and Ledger Nano S.
+Hardware wallets are a common way to personally secure your coins. We're working with Ledger to offer our official Sia app for use on both the Ledger Nano X and Ledger Nano S.
To send and receive Siacoin on a Ledger device we will be using Sia Central's web wallet through the latest version of Google Chrome desktop. Sia Central's web wallet only supports Siacoin, sending and claiming Siafund dividends are not yet supported. The web wallet should always be accessed from https://wallet.siacentral.com. This article will be using a Ledger Nano X with bluetooth, but the steps are similar for USB or the Ledger Nano S.
diff --git a/sia-integrations/using-the-sia-ledger-nano-s-app-wip.md b/sia-integrations/using-the-sia-ledger-nano-s-app-wip.md
deleted file mode 100644
index 2c38244c..00000000
--- a/sia-integrations/using-the-sia-ledger-nano-s-app-wip.md
+++ /dev/null
@@ -1,229 +0,0 @@
-# Using the Sia Ledger Nano S app
-
-## What is the Ledger Nano S?
-
-The Nano S is a hardware wallet created by Ledger. A hardware wallet stores the private keys to cryptocurrency on a separate device, making it much harder for malicious parties to steal them. In fact, the private keys never leave the Nano S itself, so they will remain secure even if the device is connected to a compromised computer. As long as you follow best practices when using your Nano S, it is virtually impossible for an attacker to steal your funds.
-
-Hardware wallets are an important part of the crypto ecosystem, and they're one of the best ways to personally secure your coins. We're happy to be working with Ledger to offer our official Sia app for use on the Ledger Nano S.
-
-## Things you'll need
-
-Using Sia on the Ledger Nano S requires a few things. You will need:
-
-* Your Ledger Nano S
-* The Sia app installed on your Nano S
-* v1.3.5 or later of `siac` and `siad` installed on your computer to connect to the Sia network
-* The `sialedger` app on your computer to talk to the Nano S
-* Familiarity with your computer's command-line interface \(CLI\).
-
-{% hint style="warning" %}
-The current process for using the Sia app is more easily followed by advanced users. If you're not comfortable using the command-line, don't worry. We're working on integrating the Sia Ledger Nano S app with Sia-UI, our official GUI app, to make the process much simpler.
-{% endhint %}
-
-## Set up your Ledger Nano S
-
-_Let's make sure your hardware wallet ready to use._
-
-1. [Initialize](https://support.ledgerwallet.com/hc/en-us/articles/360000613793) your Ledger Nano S. This gets the hardware wallet set up and ready to use.
-2. Download [Ledger Live](https://support.ledgerwallet.com/hc/en-us/articles/360006395553/) onto your computer. Ledger Live is the app you use to manage your Ledger device.
-3. [Install the latest firmware](https://support.ledgerwallet.com/hc/en-us/articles/360002731113) on your Nano S. This ensures compatibility with the Sia app.
-
-At this point, you're ready to install apps on your Ledger Nano S. Remember to store your 24-word recovery phrase in a safe place, because you'll need it to recover your funds if your device is lost or damaged.
-
-### Install the Sia Ledger Nano S app
-
-_Now we'll install the Sia app onto your Ledger hardware wallet._
-
-1. Open the **Manager** in Ledger Live.
-
-
-
-* Click the gear icon in the upper right corner to access Settings. Then click the toggle switch to enable "Developer mode".
-
-
-
-* Connect and unlock your Ledger Nano S. You may see a prompt on your Nano S to allow the manager on your device. Allow this by pressing the right button on the device.
-* Search for Sia in the app catalog.
-
-
-
-* Click the **Install** button. Your device will display **Processing...**
-
-
-
-* When the main menu reappears, the Sia app has been successfully installed.
-
-## Install siac and siad on your computer
-
-_Unlike most Ledger Nano S apps, the Sia app requires a "full node." That means you'll need to download the Sia blockchain. If you've already downloaded the blockchain, you can skip this section._
-
-**`siad`** – the Sia Daemon. This program connects to peers on the Sia network and downloads the blockchain.
-
-**`siac`** – the Sia Client. This program issues commands to siad, such as instructing it to broadcast a transaction.
-
-* Go to the [Sia downloads page](http://sia.tech/get-started).
-* Use the Sia Daemon links on the right. This will download both `siac` and `siad` to your computer.
-* Open a CLI window and navigate to the directory that contains `siac` and `siad`. Run the `./siad`command to begin downloading the blockchain to your computer.
-
-
-
-* Wait for the blockchain to finish downloading. You can monitor its progress by running `./siac` in another CLI window.
-
-
-
-## Install the sialedger app
-
-_sialedger is the command-line program you'll use on your computer to talk to the Sia app on your Nano S._
-
-* Download `sialedger` [here](https://gitlab.com/NebulousLabs/nanos-app-sia/tags/v0.4.0).
-
-{% hint style="info" %}
-Windows, macOS, and Linux are all supported.
-{% endhint %}
-
-* If you are on macOS, you may have to move sialedger to another folder \(such as Applications\) in order to run it.
-* Open a CLI window and navigate to the directory that contains sialedger.
-* Run `./sialedger` to confirm that the program works. It should print the current version.
-
-
-
-## Checking your wallet balance
-
-_There's a handful of commands you can use to interact with your siac wallet, but first, you'll need to create and unlock your wallet._
-
-{% hint style="info" %}
-The blockchain should be synced, or these commands will return errors.
-{% endhint %}
-
-`siac` Check the sync status of the Sia blockchain
-
-`siac wallet init` Create a new wallet. This will immediately provide you with your seed. Your seed is very important. Normally, you would use this seed to generate your Sia addresses, but in this case you'll be using the seed on the Nano S instead. Still, you will need this seed to unlock your wallet in the future, so make sure to write it down somewhere safe.
-
-`siac wallet unlock` Unlock your wallet.
-
-## Receiving Siacoins using the Ledger Nano S
-
-_Now that your CLI and Nano S are ready to go, let's generate an address._
-
-* Open the Sia app from the main menu of your Nano S. It should display **Waiting for commands...**
-* Run `./sialedger addr 0` from the CLI to generate key 0. You can generate other keys by specifying a different key index.
-* Your Ledger Nano S will ask you to confirm the address generation for key index 0. Confirm by pressing the right button.
-
-
-
-{% hint style="danger" %}
-Make sure the key index on the Nano S matches the key index you requested. A compromised computer could trick you by sending a different key index to the device.
-{% endhint %}
-
-* The address will appear in the CLI and on the device screen. Compare these addresses to ensure that they match. You can use the left and right buttons on the Nano S to scroll through the address.
-
-
-
-
-
-{% hint style="danger" %}
-It is crucial that you verify every character in the address. A compromised computer could trick you by displaying a different address.
-{% endhint %}
-
-* Once you've verified the address, press both buttons to return to the main Sia app screen.
-
-Your address is now ready to use! Send your existing siacoins to this address for safekeeping, or give this address to someone else to securely transfer coins to you.
-
-## Sending Siacoins using the Ledger Nano S
-
-Once you've received siacoins at an address generated by your Nano S, you can construct a transaction that spends those coins.
-
-There are three main parts to a transaction:
-
-1. You need an output to spend, for which you'll need that output's ID and the public key of the address that the output was sent to.
-2. You need to specify how to split up the value of the output. Typically, a portion of the output is sent to your intended recipient \(such as a friend\), another portion is paid to the miner, and the rest is returned to you.
-3. The transaction needs to be signed. Each output you spend needs a separate signature. We'll be using the Ledger Nano S to sign the transaction.
-
-Start by collecting everything you need to construct the transaction:
-
-* Identify an output to spend. You can find outputs by searching [https://explorer.siahub.info](https://explorer.siahub.info) for an address you generated on your Nano S. Make note of the Output ID field and its value.
-* Generate the public key of the address that owns the output. To do so, run `./sialedger pubkey n` \(where n is the same key index you used to generate the address\). Confirm the pubkey generation on the Nano S by pressing the right button.
-
-
-
-
-
-
-
-* Identify which address you want to send siacoins to.
-* Choose a fee to pay to the miner.
-* Generate a "return address" where you will receive the leftover portion of the output. Refer to [Receiving Siacoins](using-the-sia-ledger-nano-s-app-wip.md#receiving-siacoins-using-the-ledger-nano-s) for how to do this.
-
-## Building a transaction
-
-_You are now ready to construct a transaction by substituting these values into the example below._
-
-Note: the following are example values and may not match the values seen in earlier screenshots.
-
-```go
-{
- "siacoininputs": [{
- // The ID of the Siacoin Output that you are spending.
- // In this case, the output is worth 10 SC.
- "parentid": "48dcaacaf0ecb0ffce702b9115365e52b3cacc01ae87a70d8ca47349fbdc6831",
- "unlockconditions": {
- "signaturesrequired": 1,
- // The public key of the output.
- "publickeys": [ "ed25519:8b845bf4871bcdf4ff80478939e508f43a2d4b2f68e94e8b2e3d1ea9b5f33ef1" ]
- }
- }],
- "siacoinoutputs": [
- // The first output sends 5 SC to a friend.
- {
- // The address you are sending siacoins to.
- "unlockhash": "17d25299caeccaa7d1598751f239dd47570d148bb08658e596112d917dfa6bc8400b44f239b1",
- // The number of Hastings sent to this address.
- "value": "5000000000000000000000000"
- },
- // The second output returns 4 SC to you.
- {
- // This should be an address that you control.
- "unlockhash": "996b3fc7de889073b1fffcaa52c18c447cbcf4f6d7825e16e88b73d2ae1aa74cbd96f1f16991",
- "value": "4000000000000000000000000"
- }
- ],
- // The number of Hastings to pay to the miner (in this case, 1 SC).
- "minerfees": [ "1000000000000000000000000" ],
- "transactionsignatures": [{
- // The ID of the Siacoin Output that you are spending.
- "parentid": "48dcaacaf0ecb0ffce702b9115365e52b3cacc01ae87a70d8ca47349fbdc6831",
- "coveredfields": { "wholetransaction": true }
- }]
-}
-```
-
-* Save this transaction to a file. We'll assume the file is named `txn.json`. Move it to the same directory as the `sialedger` app.
-* Run `./sialedger txn txn.json 0 n`, where `n` is the same key index you used to generate the public key earlier.
-* The Nano S will display each part of the transaction. Scroll with the left and right buttons, and proceed by pressing both buttons.
-* Once you have reviewed each part of the transaction, you will be asked to confirm that you want to sign the transaction. Press the right button to confirm.
-
-
-
-* The CLI will display the signature generated by the Nano S.
-
-
-
-* Open the `txn.json` file and insert the signature near the end of the file, below `transactionsignatures` and above `parentid`:
-
-```go
-"transactionsignatures": [{
- // The new signature line goes right here.
- "signature": "SHXPNf5WxLbwkWL607Od+QCcdnALZdzWLztKRLraToyrItC9EWPItdQbdo897yIEsjgcIUz5Hd7zSjLNVxmTDg==",
- "parentid": "48dcaacaf0ecb0ffce702b9115365e52b3cacc01ae87a70d8ca47349fbdc6831",
- "coveredfields": { "wholetransaction": true }
- }]
-```
-
-The transaction is now valid. To broadcast it to the Sia network, simply move txn.json to the folder you run Sia commands from, and run:
-
-`siac wallet broadcast txn.json`
-
-## Get help
-
-If you're having trouble, we're here to help. [Email our official support](mailto:hello@sia.tech), or [join our Discord server](https://discord.gg/sia) and post in the \#core-dev or \#app-dev channels.
-
diff --git a/siafunds/how-to-cash-out-siafunds.md b/siafunds/how-to-cash-out-siafunds.md
deleted file mode 100644
index 356a4eeb..00000000
--- a/siafunds/how-to-cash-out-siafunds.md
+++ /dev/null
@@ -1,49 +0,0 @@
-# Withdrawing Siafunds
-
-If you're a Siafund owner, you can cash out these accrued Siacoins at any point by sending your Siafunds to your Sia address. This can be the same wallet the Siafunds are currently in or a different wallet you control.
-
-{% hint style="info" %}
-You **do not** lose the Siafunds in this process. You'll always retain control unless you send them to someone else or a bad address.
-{% endhint %}
-
-## Generate a Sia address
-
-Click **Receive.** in the top right hand corner to get your wallet address.
-
-
-
-Click the drop down arrow and copy your address. You will be using it in the next step to send your Siafund.
-
-
-
-## Send your Siafunds to this address
-
-Now switch over to the Send section of your wallet by clicking **Send** in the top right.
-
-
-
-You will see a **Send** dialog pop up. Enter the wallet address and the amount of Siafunds you want to send. Make sure that you've entered a Sia wallet address you control, and that you've entered it correctly.
-
-
-
-{% hint style="danger" %}
-Siafunds sent to mistyped addresses cannot be retrieved.
-{% endhint %}
-
-Click **Generate Transaction.**
-
-## Sign & Send
-
-Next, you need to verify everything. You'll have a chance to double-check the currency, amount, and recipient address. If everything looks good, enter your wallet seed phrase and click **Sign and broadcast transaction**.
-
-
-
-## Check the status
-
-You'll immediately get a confirmation that your transaction has been broadcast to the network. Note that it will take ~10 min for your transaction to be sent through.
-
-
-
-{% hint style="success" %}
-Once the transaction has been complete, your wallet will be credited with any accrued Siacoin generated from your Siafund.
-{% endhint %}
\ No newline at end of file
diff --git a/siafunds/learn-about-siafunds.md b/siafunds/learn-about-siafunds.md
deleted file mode 100644
index 74b95d59..00000000
--- a/siafunds/learn-about-siafunds.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Learn about Siafunds
-
-## Overview: Siafunds
-
-Siafunds serve as tokens utilized for revenue sharing within the Sia network, wherein a 3.9% fee from every storage-related transaction on the Sia platform is allocated to Siafund holders. Roughly 1,400 Siafunds were initially distributed to investors through securities sales, while Skynet Labs presently holds the remaining ~8,600 Siafunds.
-
-When contractually completed on the network, 3.9% of each funding source, including renter fees for storage, renter bandwidth costs, and host collateral, is earmarked for Siafund holders. The reserved amount is equitably dispersed upon contract completion among all Siafund holders.
-
-The creation of Siafunds was driven by the goal of establishing a sustainable means of funding the development of the Sia network. These tokens incentivize and empower both ourselves and investors to actively support and enhance the Sia network by capturing a portion of its growing revenue. As the user base expands and more users pay for storage, Siafund revenues increase, providing additional resources for developing Sia-supported software.
-
-### Siacoins vs Siafunds
-
-Utility tokens, such as Siacoins, primarily gain value through their utilization on a blockchain platform. In contrast, Siafunds derive their value from both the current and anticipated worth of the Sia storage network.
-
-### Limited Supply
-
-The maximum number of Siafunds that will ever be issued is 10,000, and all of these were generated at the launch of the Sia software in 2015. Given that the quantity, size, and value of contracts on the Sia network are rising, the revenue per Siafund increases proportionally as the number of issued Siafunds remains constant.
-
-Initially, Nebulous, Inc. held all 10,000 Siafunds. However, they have conducted multiple Siafund sales to support development. In 2021, Nebulous rebranded as Skynet Labs and still retains approximately 8,600 Siafunds, while the rest have been distributed to third parties.
-
-## How to obtain Siafunds
-
-Siafunds are typically unavailable on mainstream exchanges due to their classified securities by the SEC under United States laws in 2018. This classification makes most exchanges unwilling to comply with the requisite regulatory requirements for trading in securities. If you are in the United States, you may need to qualify as an accredited investor to engage in Siafunds transactions.
-
-{% hint style="danger" %}
-**We strongly advise researching the relevant securities regulations in your country before considering buying or selling Siafunds and seeking legal counsel for guidance in this matter.**
-{% endhint %}
-
-Siafunds are typically bought and sold through the `#siafunds` channel on the Sia [Discord](https://sia.tech/discord) server, where over-the-counter trades are facilitated.
-
-## How to store Siafunds
-
-Siafunds are stored in `walletd`, right next to your Siacoins.
-
-
-
-You can also send and receive Siafunds to and from standard Siacoin addresses, and they can be recovered using your Siacoin balance as long as you possess your Sia seed.
diff --git a/siafunds/sec-settlement-faq.md b/siafunds/sec-settlement-faq.md
deleted file mode 100644
index 6f92d57d..00000000
--- a/siafunds/sec-settlement-faq.md
+++ /dev/null
@@ -1,68 +0,0 @@
-# SEC Settlement
-
-## **Overview**
-
-In October 2019, Nebulous settled with the SEC regarding a claim related to the unregistered offering and sale of Sianotes in May 2014 and the conversion of Sianotes into Siafunds in June 2015. It's important to note that, as outlined in the settled order, the SEC did not take any enforcement action concerning the Siacoin (SC) token or any ongoing activities on the Sia network. Furthermore, the order does not require Nebulous to register the Siacoin token as a security with the SEC.
-
-Following their investigation and as indicated in the settled order, the SEC determined that Siafunds should be classified as securities. Therefore, failing to register the 2014 offering and the 2015 conversion was deemed a violation of Section 5 of the Securities Act 1933.
-
-## Components of the Network
-
-### Two-token model
-
-Sia uses two tokens, [Siacoins](../get-started-with-sia/learn-about-siacoins.md) and [Siafunds](learn-about-siafunds.md)**.**
-
-We endorse Sia's two-token model, which fosters an optimal ecosystem. This system incentivizes the Sia core team and Siafund investors to prioritize product development and ensure the network's long-term, sustainable growth.
-
-{% hint style="info" %}
-Check out our [blog post](https://blog.sia.tech/the-ico-paradox-and-how-to-fix-it-3bfc61bc6eb8), where we discuss Sia's two-token model and address the challenges associated with ICOs.
-{% endhint %}
-
-### Sianote
-
-Sianotes served as precursors to Siafunds. In 2014, we made Sianotes available to investors, and in mid-2015, when the Sia network was launched, we exchanged them for Siafunds. It's worth emphasizing that Sianotes were acquired in exchange for Bitcoin and were issued on the NXT Asset Exchange.
-
-The Sia team did not knowingly sell unregistered securities. During the 2014 offering, we were unaware that the SEC might consider Sianotes or Siafunds securities. This offering took place months before Ethereum's emergence and years before the SEC issued guidance related to cryptocurrencies.
-
-While we appropriately registered our 2018 offering of Siafunds in response to the SEC's 2017 guidance regarding digital assets, we are disappointed that the SEC opted to take action regarding our relatively small 2014 offering.
-
-## **Impact on the Sia Ecosystem**
-
-### **Sia Network**
-
-The SEC settlement has no impact on the Sia network. As indicated in the settlement terms, the SEC took no enforcement action regarding the Siacoin token or ongoing Sia network activities. Nebulous is not obliged to register the Siacoin token as a security with the SEC. After an extensive SEC investigation, no changes or restrictions were imposed on the Sia network.
-
-### **Sia Project**
-
-The SEC did not pursue enforcement actions against the Siacoin token or ongoing Sia network activities. There were no criminal charges brought against Nebulous or the Sia core developers. The cryptocurrency community may see the settlement as a reinforcement for the Sia project, given the SEC's decision not to take any enforcement action related to the Siacoin token.
-
-### Sia Foundation
-
-The settlement does not impact our decision to conduct future offerings of Siafunds. Similar to our 2018 offering, we will classify future Siafunds offerings as securities unless there are changes in regulatory guidance.
-
-### **Exchanges**
-
-The listing of Siacoin on exchanges remains unaffected. The SEC did not initiate enforcement actions concerning the Siacoin token or ongoing Sia network activities. Nebulous is not required to register the Siacoin token as a security with the SEC, and the SEC had comprehensive information about Siacoins, including their trading on various global exchanges. We are ready to provide any exchange with a legal opinion regarding Siacoin's status under U.S. securities law.
-
-### **Community**
-
-The recent settlement does not impact users or holders of Siacoins for cloud storage rentals. The SEC refrained from taking enforcement actions regarding Siacoins despite understanding how they are created and used. You can continue using Siacoins on the Sia network if you rent cloud storage. Siacoin holders can store them in wallets or trade them on supported exchanges.
-
-For Siacoin miners, the settlement does not affect their operations. The SEC did not pursue enforcement actions despite understanding Siacoin's creation and usage. Miners can confidently continue their activities.
-
-The settlement does not affect Siafunds purchased during the April 2018 offering. The offering was conducted in full compliance with regulations, following SEC guidelines under Regulation D. All Siafunds acquired during the 2018 offering were distributed to investors after a one-year lockup period.
-
-It's important to note that the SEC classified Siafunds as securities under U.S. laws. If you exchanged Sianotes for Siafunds in 2014, we recommend researching relevant securities laws in your country. In the United States, accredited investor status may be required to buy or sell Siafunds.
-
-{% hint style="danger" %}
-**We strongly advise consulting with an attorney for guidance on this matter.**
-{% endhint %}
-
-{% hint style="info" %}
-For more detailed information, please visit the following links:
-
-* [SEC Settlement](https://www.sec.gov/litigation/admin/2019/33-10715.pdf)
-* [SEC Administrative Summary](https://www.sec.gov/enforce/33-10715-s)
-* [SEC Waiver](https://www.sec.gov/rules/other/2019/33-10716.pdf)
-* [Waiver Request Letter](https://www.sec.gov/divisions/corpfin/cf-noaction/2019/nebulous-093019-506.pdf)
-{% endhint %}
diff --git a/testnet/zen-testnet.md b/testnet/zen-testnet.md
index da110ce9..e838896f 100644
--- a/testnet/zen-testnet.md
+++ b/testnet/zen-testnet.md
@@ -16,13 +16,13 @@ layout:
The Sia Foundation has made a test environment available for users wishing to test hardforks, software developments, and integration within the Sia ecosystem via the Zen Testnet.
-The Zen Testnet offers a secure environment to experiment with `renterd`, `hostd`, and `walletd`and explore the capabilities of Siacoin without the risk of losing real Siacoins, but also with no real-world value.
+The Zen Testnet lets you experiment with `renterd`, `hostd`, and `walletd` using Siacoins that have no real-world value, so there is no risk of losing real Siacoins.
## Running testnet
Running our software on the testnet is similar to running it on the mainnet. First, download the binary for [renterd](https://sia.tech/rent), [hostd](https://sia.tech/host), or [walletd](https://sia.tech/wallet) from our official website. Then, follow the same setup instructions for [renterd](../renting/setting-up-renterd/), [hostd](../hosting/setting-up-hostd/) or [walletd](../wallet/setting-up-walletd/), up until the point of running the software.
-For Linux or macOS users, then simply run the software with the testnet runtime flag:
+For Linux or macOS users, run the software with the testnet runtime flag:
```
renterd --network=zen
@@ -40,7 +40,7 @@ walletd -network=zen
## Funding your testnet address
-With the availability of zSC, the [Zen Testnet faucet](https://zen.siascan.com/faucet) provides a convenient way to acquire zSC by simply providing your Sia wallet's address.
+The [Zen Testnet faucet](https://zen.siascan.com/faucet) lets you acquire zSC by providing your Sia wallet's address.
Once on the page, enter a Sia wallet address of either `renterd`, `hostd`, or `walletd` , then enter the amount of Zen Siacoins (zSC) you wish to fund that address with.
@@ -52,9 +52,9 @@ It might take a minute or two for your wallet to be funded and for the transacti
## Block Explorer
-Our web-based block explorer and analytics tool is tailored for the Sia network. This comprehensive platform offers users a wide range of insights into the intricacies of the Siacoin network.
+Our web-based block explorer and analytics tool is built for the Sia network. It provides information about the Siacoin network.
-Visit [SiaScan Zen](https://zen.siascan.com), our block explorer, to gain valuable insights into the testnet's activity, view transaction history, and monitor block confirmations.
+Visit [SiaScan Zen](https://zen.siascan.com), our block explorer, to view the testnet's activity, transaction history, and block confirmations.
Siascan Zen
diff --git a/v2/README.md b/v2/README.md
index f0758795..3994037f 100644
--- a/v2/README.md
+++ b/v2/README.md
@@ -18,7 +18,7 @@ The Sia network hardfork activated at block 526,000 on June 6th, 2025. All major
## Details of the fork
-The Sia network forked to radically update Sia's consensus code, bringing huge benefits to performance, scalability, and functionality. Given the significance of this hardfork, we've come to refer to it as **Sia v2**.
+The Sia network forked to update Sia's consensus code, improving performance, scalability, and functionality. Given the scope of this hardfork, we refer to it as **Sia v2**.
Upgrading to Sia v2 is necessary to send or store coins, rent, or host after the fork. Every user, exchange, mining pool, wallet, and integration must upgrade.
@@ -58,13 +58,13 @@ The actual hardfork -- the point at which you _must_ be running a v2 node -- occ
#### ...renters and hosts?
-Sia v2 includes an update to the renter-host protocol that is faster and more efficient in almost every measurable way. Here are some highlights:
+Sia v2 includes an update to the renter-host protocol that is faster and more efficient. Notable changes:
* Many more options and flexibility for your contracts
* Faster uploads and downloads, including concurrent uploads to the same host
* Enables decentralized uploads and downloads in a browser, no plugins or daemons necessary
-It's important for renters and hosts to upgrade if they have not already so that they can enjoy the benefits of v2 and the new renter-host protocol as soon as possible.
+Renters and hosts who have not yet upgraded should do so to use v2 and the new renter-host protocol.
#### ...Siacoin holders?
@@ -81,13 +81,13 @@ We recommend that all Siacoin holders who have not upgraded to `walletd` to do s
#### ...for miners?
-We've carefully designed Sia v2 to preserve the layout of block headers, so all mining hardware will remain compatible. You should, however, check in with your mining pool to make sure they've updated.
+Sia v2 preserves the layout of block headers, so all mining hardware remains compatible. You should, however, check in with your mining pool to make sure they've updated.
#### ...for exchanges?
-Sia v2 will enable highly increased performance and usability for your exchange. You'll have more control over your Siacoin treasury and the ways you interact with it.
+Sia v2 gives you more control over your Siacoin treasury and the ways you interact with it.
-Exchanges should upgrade to `walletd` v2 as soon as possible to ensure an issue-free transition. Due to the volume of users you serve, you should leave time for a proper upgrade. Once you do, your exchange will be able to support the fork once it takes effect.
+Exchanges should upgrade to `walletd` v2 as soon as possible. Due to the volume of users you serve, leave time for a proper upgrade. Once you do, your exchange will be able to support the fork once it takes effect.
## More questions?
diff --git a/v2/exchanges.md b/v2/exchanges.md
index 483f0330..2bf72865 100644
--- a/v2/exchanges.md
+++ b/v2/exchanges.md
@@ -20,7 +20,7 @@ This guide is for exchanges that are currently using `siad` to track and manage
The hardfork activated at the block height of **526,000** on or around **June 6th, 2025 06:00 UTC**.
{% endhint %}
-`walletd` is the new reference wallet for exchanges. It is designed to be more secure, reliable, and scalable than `siad`. `walletd` also has a more robust API, supports multiple wallets simultaneously, and provides easier support for secure key management setups.
+`walletd` is the new reference wallet for exchanges. It supports multiple wallets simultaneously and provides easier support for secure key management setups.
### Differences from `siad`
diff --git a/wallet/setting-up-walletd/README.md b/wallet/setting-up-walletd/README.md
index 0319b6a8..6c8fbddb 100644
--- a/wallet/setting-up-walletd/README.md
+++ b/wallet/setting-up-walletd/README.md
@@ -1,2 +1,10 @@
# Setting up walletd
+`walletd` is the Sia Foundation's standalone wallet for Siacoin (and Siafunds). It supports multiple wallets and Ledger hardware wallets. These guides walk you through installing and configuring it.
+
+Choose an install method:
+
+- [Linux](linux/) — apt package (Debian or Ubuntu) or a manual binary.
+- [Docker](docker.md)
+- [macOS](macos.md) — desktop app.
+- [Windows](windows.md) — desktop app.
diff --git a/wallet/setting-up-walletd/docker.md b/wallet/setting-up-walletd/docker.md
index d90e97b0..73b1c1a1 100644
--- a/wallet/setting-up-walletd/docker.md
+++ b/wallet/setting-up-walletd/docker.md
@@ -68,7 +68,7 @@ docker compose pull
## Configuring `walletd`
-Now that you have the latest `walletd` image downloaded, you will need to create a seed phrase and admin password. To launch the built-in configuration wizard, run the following:
+Now that you have the latest `walletd` image downloaded, you will need to set an admin password to unlock the web UI. To launch the built-in configuration wizard, run the following:
```console
docker compose run --rm -it walletd config
@@ -90,7 +90,7 @@ Finally, you will be asked if you want to configure advanced settings for `walle
## Running `walletd`
-Now that you have `walletd` successfully installed and configured, it is time to run it. Use the following command to start `walletd`:
+Now that you have `walletd` installed and configured, use the following command to start it:
```console
docker compose up -d
@@ -98,12 +98,12 @@ docker compose up -d
-Once `walletd` has successfully started, you can access the web UI by opening your browser and going to [http://localhost:9980](http://localhost:9980/).
+Once `walletd` has started, you can access the web UI by opening your browser and going to [http://localhost:9980](http://localhost:9980/).
{% hint style="success" %}
-Congratulations, you have successfully set up `walletd`.
+You have set up `walletd`.
{% endhint %}
## Checking the container status
@@ -128,7 +128,7 @@ docker compose logs walletd
## Upgrading `walletd`
-It is essential to keep your `walletd` up to date. New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
+Keep your `walletd` up to date. New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
To upgrade your `walletd` to the newest version, make sure you have shut down `walletd` and then run the following:
@@ -139,5 +139,5 @@ docker compose pull && docker compose up -d
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `walletd`!
+You have updated your version of `walletd`.
{% endhint %}
diff --git a/wallet/setting-up-walletd/linux/other.md b/wallet/setting-up-walletd/linux/other.md
index 2f585e94..bd30febc 100644
--- a/wallet/setting-up-walletd/linux/other.md
+++ b/wallet/setting-up-walletd/linux/other.md
@@ -13,7 +13,7 @@ layout:
visible: true
---
-# Linux
+# Other Linux Distributions
This guide will walk you through setting up `walletd` on Linux. At the end of this guide, you should have the following:
@@ -94,11 +94,11 @@ rm -rf walletd_linux_arm64.zip
`walletd` can manage multiple wallets, so the configuration wizard does not prompt for a seed. You create or import wallets from the web interface after `walletd` is running.
{% endhint %}
-1. Before running the `walletd` configuration wizard, make sure to `cd` into the `walletd` runtime folder you created in the last section. Then run the `walletd` configuration wizard. This will generate a `walletd.yml` file that is used by `walletd` on start-up. You will be asked to set a password to unlock the web interface and optionally configure advanced settings such as the index mode.
+1. Run the `walletd` configuration wizard from your `walletd` folder. Setting `WALLETD_CONFIG_FILE` tells the wizard to write `walletd.yml` into this folder; otherwise, on Linux it would be saved to `/etc/walletd/walletd.yml`, which requires root. This `walletd.yml` is used by `walletd` on start-up. You will be asked to set a password to unlock the web interface and optionally configure advanced settings such as the index mode.
```console
cd /path/to/walletd/folder
- walletd config
+ WALLETD_CONFIG_FILE=walletd.yml walletd config
```
## Start `walletd`
@@ -124,7 +124,7 @@ If you do not have a desktop environment:
## Updating
-It is important to keep your node up to date. New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
+Keep your node up to date. New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
**To update:**
@@ -170,5 +170,5 @@ rm -rf walletd_linux_arm64.zip
```
{% hint style="success" %}
-Congratulations, you have successfully updated your version of `walletd`!
+You have updated your version of `walletd`.
{% endhint %}
diff --git a/wallet/setting-up-walletd/macos.md b/wallet/setting-up-walletd/macos.md
index 533af85b..987851dc 100644
--- a/wallet/setting-up-walletd/macos.md
+++ b/wallet/setting-up-walletd/macos.md
@@ -15,7 +15,7 @@ layout:
# macOS Desktop App: `walletd`
-The `walletd` desktop app provides a user-friendly web UI to manage your Sia wallets. By the end of this guide, you will have:
+The `walletd` desktop app provides a web UI to manage your Sia wallets. By the end of this guide, you will have:
* Installed the `walletd` desktop application.
* Created a `walletd` wallet
@@ -70,20 +70,20 @@ After downloading the `walletd` desktop application:
4. **Access the Web UI:** Click **save and start daemon**. It will open automatically, or if not, you can access it at [http://localhost:9980](http://localhost:9980) while `walletd` runs in the background.
{% hint style="warning" %}
-When you first run `walletd`, macOS may ask to allow incoming network connections. This is normal — select **Allow** so `walletd` can communicate properly.
+When you first run `walletd`, macOS may ask to allow incoming network connections. Select **Allow** so `walletd` can communicate.
{% endhint %}
{% hint style="success" %}
-**Success!** `walletd` is now running on your Mac, and you’re ready to start managing your wallets on the Sia network.
+`walletd` is now running on your Mac, and you can start managing your wallets on the Sia network.
{% endhint %}
## Configure
-You can customize `walletd` through the desktop app, which provides full control over all available settings, from wallet indexing to batch sizing and more.
+You can configure `walletd` through the desktop app, which exposes all available settings, from wallet indexing to batch sizing.
-On **macOS**, you can access the `walletd` configurations by clicking the `walletd` icon in the menu bar at the top of your screen. This will open the configuration window and let you customize its behavior.
+On **macOS**, you can access the `walletd` configurations by clicking the `walletd` icon in the menu bar at the top of your screen. This will open the configuration window.
@@ -107,13 +107,13 @@ There are several configurable settings in `walletd`. Below is a breakdown of wh
Always **save and restart daemon** after making configuration changes to ensure they are applied.
{% endhint %}
-You can monitor your node’s activity and track changes by checking the logs. These provide detailed information about the system, network connections, and API endpoints, helping you understand what your node is doing at any given time.
+You can monitor your node’s activity by checking the logs. These provide information about the system, network connections, and API endpoints.
## Update
-`walletd` updates regularly with bug fixes, performance improvements, and new features. Updating your node ensures stability and compatibility with the Sia network.
+`walletd` updates regularly with bug fixes, performance improvements, and new features. Updating your node keeps it compatible with the Sia network.
-On macOS, the app downloads updates automatically and notifies you when they’re ready. Simply restart the app to run the latest version.
+On macOS, the app downloads updates automatically and notifies you when they’re ready. Restart the app to run the latest version.
{% hint style="info" %}
You can always check for the version of the software at the bottom of the app interface.
diff --git a/wallet/setting-up-walletd/windows.md b/wallet/setting-up-walletd/windows.md
index bccb48de..434014f0 100644
--- a/wallet/setting-up-walletd/windows.md
+++ b/wallet/setting-up-walletd/windows.md
@@ -14,7 +14,7 @@ layout:
# Windows Desktop App: `walletd`
-The `walletd` desktop app provides a user-friendly web UI to start storing data on the Sia network. By the end of this guide, you will have:
+The `walletd` desktop app provides a web UI to manage your Sia wallets. By the end of this guide, you will have:
* Installed Sia `walletd` software
* Created a `walletd` wallet
@@ -60,20 +60,20 @@ After downloading the `walletd` desktop application:
{% hint style="warning" %}
-When you first run `walletd`, Windows Security may ask to allow public and private network access. This is normal—select **Allow** so `walletd` can communicate properly through the firewall.
+When you first run `walletd`, Windows Security may ask to allow public and private network access. Select **Allow** so `walletd` can communicate through the firewall.
{% endhint %}
{% hint style="success" %}
-**Success!** `walletd` is now running on your Windows system, and you’re ready to start storing your data on the Sia network.
+`walletd` is now running on your Windows system, and you can start managing your wallets on the Sia network.
{% endhint %}
## Configure
-You can customize `walletd` through the desktop app, which provides full control over all available settings, from wallet indexing to batch sizing and more.
+You can configure `walletd` through the desktop app, which exposes all available settings, from wallet indexing to batch sizing.
-On **Windows**, you can access the `walletd` configurations by going to the taskbar, expanding the up arrow to see hidden icons, and double-clicking the `walletd` app. This will open the configuration window and let you customize its behavior.
+On **Windows**, you can access the `walletd` configurations by going to the taskbar, expanding the up arrow to see hidden icons, and double-clicking the `walletd` app. This will open the configuration window.
@@ -97,15 +97,15 @@ There are several configurable settings in `walletd`. Below is a breakdown of wh
Always **save and restart daemon** after making configuration changes to ensure they are applied.
{% endhint %}
-You can monitor your node’s activity and track changes by checking the logs. These provide detailed information about the system, network connections, API endpoints, S3 interface, and autopilot operations, helping you understand what your node is doing at any given time.
+You can monitor your node’s activity by checking the logs. These provide information about the system, network connections, and API endpoints.
## Update
-`walletd` updates regularly with bug fixes, performance improvements, and new features. Updating your node ensures stability and compatibility with the Sia network.
+`walletd` updates regularly with bug fixes, performance improvements, and new features. Updating your node keeps it compatible with the Sia network.
-On Windows, the app downloads updates automatically and notifies you when they’re ready. Simply restart the app to run the latest version.
+On Windows, the app downloads updates automatically and notifies you when they’re ready. Restart the app to run the latest version.
{% hint style="info" %}
You can always check for the version of the software at the bottom of the app interface.
diff --git a/wallet/transferring-siacoins.md b/wallet/transferring-siacoins.md
index 82c4a66d..82f51bbf 100644
--- a/wallet/transferring-siacoins.md
+++ b/wallet/transferring-siacoins.md
@@ -16,7 +16,7 @@ layout:
## Sending Siacoins
-Whether you're sending Siacoins (SC) to an exchange or a friend, it's easy and can be done right. You can check the transaction status in `walletd`.
+You can send Siacoins (SC) to an exchange or a friend and check the transaction status in `walletd`.
Go to `walletd`. If you're asked to unlock the wallet, use your seed or a custom password if you've set one. If you haven't got a wallet set up, visit our[ Setting up `walletd`](setting-up-walletd/) guide; otherwise, choose from the **Dashboard** a wallet you wish to send Siacoins from.
@@ -44,7 +44,7 @@ Click **Setup** to change something. If it's all good, click **Sign and broadcas
Confirmation of a successful transaction broadcasted
-You'll immediately get a confirmation that your transaction has been successfully broadcasted.
+You'll get a confirmation that your transaction has been broadcast.
### Checking the status
@@ -60,7 +60,7 @@ Once it's in a block, you can check the status and see a new transaction type of
## Receiving Siacoins
-At some point, you'll need to receive Siacoins. You might be receiving them from an exchange wallet, another Sia wallet you own, or requesting Siacoins from a friend. No matter the reason, it's easy to generate or retrieve your address in `walletd` to receive Siacoins.
+You might receive Siacoins from an exchange wallet, another Sia wallet you own, or from a friend. To receive Siacoins, generate or retrieve your address in `walletd`.
Go to the `walletd`. If you're asked to unlock the wallet, use your seed or a custom password if you've set one. If you haven't got a wallet set up, visit our [Setting up walletd](setting-up-walletd/) guide; otherwise, choose from the **Dashboard** a wallet you wish to receive Siacoins from.
diff --git a/wallet/wallet-overview.md b/wallet/wallet-overview.md
index 7f7eeb66..f2700592 100644
--- a/wallet/wallet-overview.md
+++ b/wallet/wallet-overview.md
@@ -15,18 +15,16 @@ layout:
# Your Sia Wallet
\
-The Sia Wallet is the official cryptocurrency wallet designed exclusively for Siacoins (SC). This secure and user-friendly platform allows you to store, send, receive, and manage your Siacoin holdings.
+`walletd` is the Sia Foundation's standalone wallet for Siacoin (SC) and Siafunds. It can manage multiple wallets and supports Ledger hardware wallets, through either a command-line interface or a web interface.
-While `renterd` and `hostd` have their respective Sia Wallets, it's important to highlight `walletd` as Sia's primary solution for securing your Siacoins. With `walletd` seamlessly integrated into the Sia network and ecosystem, it makes it the inclusive choice for managing your Siacoins.
+`renterd`, `hostd`, and `indexd` each include a built-in wallet for the coins they spend. `walletd` is the separate, general-purpose wallet for holding and moving your own Siacoin, independent of those services.
-Utilizing `walletd` prioritizes user convenience and security within the network, offering an official web application as the ultimate hub for Siacoin management and transactions. Some key features include:
+`walletd` can index either just your own addresses or the entire chain, and it can hold your seed to send and receive or run watch-only — tracking addresses without access to private keys. Some of its features:
-* Securely send, receive, and store Siacoins and Siafunds.
-* Stay informed by monitoring the blockchain for events relevant to specific addresses.
-* Easily track your wallet balance and transaction history.
-* Seamlessly integrate with Ledger hardware wallets.
-
-Whether you prefer the command-line interface's flexibility or the web-based interface's ease of use, `walletd` ensures top-notch Siacoin management and security. Discover the best-in-class Siacoin management and protection with `walletd`, the official wallet solution developed by the creators of the Sia network.
+* Send, receive, and store Siacoins and Siafunds.
+* Manage multiple wallets, including watch-only and Ledger hardware wallets.
+* Track wallet balances and transaction history.
+* Monitor the blockchain for activity on specific addresses.
{% hint style="info" %}
#### **Getting Started with `walletd`**
