diff --git a/.gitbook/assets/macos-walletd-app/dmg-install.png b/.gitbook/assets/macos-walletd-app/dmg-install.png
new file mode 100644
index 0000000..c5df737
Binary files /dev/null and b/.gitbook/assets/macos-walletd-app/dmg-install.png differ
diff --git a/.gitbook/assets/macos-walletd-app/downloads.png b/.gitbook/assets/macos-walletd-app/downloads.png
new file mode 100644
index 0000000..c125c7f
Binary files /dev/null and b/.gitbook/assets/macos-walletd-app/downloads.png differ
diff --git a/.gitbook/assets/macos-walletd-app/menu-bar.png b/.gitbook/assets/macos-walletd-app/menu-bar.png
new file mode 100644
index 0000000..f53ce7b
Binary files /dev/null and b/.gitbook/assets/macos-walletd-app/menu-bar.png differ
diff --git a/.gitbook/assets/macos-walletd-app/web-ui.png b/.gitbook/assets/macos-walletd-app/web-ui.png
new file mode 100644
index 0000000..f6bc2e5
Binary files /dev/null and b/.gitbook/assets/macos-walletd-app/web-ui.png differ
diff --git a/.gitbook/assets/macos-walletd-app/welcome-ui.png b/.gitbook/assets/macos-walletd-app/welcome-ui.png
new file mode 100644
index 0000000..4f4c612
Binary files /dev/null and b/.gitbook/assets/macos-walletd-app/welcome-ui.png differ
diff --git a/SUMMARY.md b/SUMMARY.md
index 293f6fd..bac20fd 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -47,7 +47,10 @@
* [Your Sia Wallet](wallet/wallet-overview.md)
* [Setting up walletd](wallet/setting-up-walletd/README.md)
- * [Linux](wallet/setting-up-walletd/linux.md)
+ * [Linux](wallet/setting-up-walletd/linux/README.md)
+ * [Debian](wallet/setting-up-walletd/linux/debian.md)
+ * [Ubuntu](wallet/setting-up-walletd/linux/ubuntu.md)
+ * [Other](wallet/setting-up-walletd/linux/other.md)
* [Docker](wallet/setting-up-walletd/docker.md)
* [macOS](wallet/setting-up-walletd/macos.md)
* [Windows](wallet/setting-up-walletd/windows.md)
diff --git a/wallet/setting-up-walletd/linux.md b/wallet/setting-up-walletd/linux.md
deleted file mode 100644
index f0e1b7c..0000000
--- a/wallet/setting-up-walletd/linux.md
+++ /dev/null
@@ -1,105 +0,0 @@
----
-layout:
- title:
- visible: true
- description:
- visible: true
- tableOfContents:
- visible: true
- outline:
- visible: true
- pagination:
- visible: true
----
-
-# Linux
-
-This guide will walk you through setting up `walletd` on Linux. At the end of this guide, you should have:
-
-* Installed Sia `walletd` software
-* Created a `walletd` wallet
-
-## Pre-requisites
-
-To run `walletd` on Linux, your system should meet the following specifications:
-
-* **Operating System Compatibility:** `walletd` is supported on the following Linux versions:
- - Trixie (Debian 13)
- - Bookworm (Debian 12)
- - Bullseye (Debian 11)
- - Plucky (Ubuntu 25.04)
- - Noble (Ubuntu 24.04)
- - Jammy (Ubuntu 22.04)
-
-* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
- - A quad-core CPU
- - 8GB of RAM
- - 256 GB SSD for `walletd`
-
-* **System Updates:** Ensure that your Linux system is up to date with the latest system updates, as these updates can contain important security fixes and improvements.
-
-* **Network Access:** `walletd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
-
-## Getting `walletd`
-
-1. Download the latest version of `walletd` for your operating system from the [official website](https://sia.tech/software/walletd). For this guide, we'll be downloading the Linux version of `walletd` .
-2. Now that we have downloaded `walletd`, it's recommended to unzip the `walletd` binary to `/usr/local/bin`. Right-click the unzip file, select **Open Terminal Here** to open your Terminal Emulator, and run the following commands:
-
-```bash
-unzip walletd_linux_arm64.zip
-sudo mv -t /usr/local/bin walletd
-rm -rf walletd_linux_arm64.zip
-```
-
-{% hint style="info" %}
-You'll be prompted to authorize this action by providing your system password. Type this in and press enter to continue.
-{% endhint %}
-
-3. Finally, for good practice, create a folder on the home drive. This folder will be utilized specifically to store data related to the `walletd` software. Open the Terminal Emulator and run the following command:
-
-```bash
-mkdir ~/walletd
-```
-
-## Running `walletd`
-
-1. Run the following in your Terminal Emulator to start `walletd`:
-
-```bash
- walletd
-```
-
-You will be prompted to input a `API password`. You choose this password, which can be anything you want. It will be used to unlock the `walletd` UI, via your browser, should be something secure and easy to remember. This value is not stored anywhere; you will need to re-enter it every time you start `walletd`.
-
-{% hint style="info" %}
-You can also set the `WALLETD_API_PASSWORD` environment variables so you do not have to re-enter the values every time.
-{% endhint %}
-
-2. After entering your desired `API password`, `walletd` will start.
-
-
Starting walletd
-
-3. You can now access the `walletd` UI by opening a browser and going to `http://localhost:9980`.
-
-{% hint style="warning" %}
-Remember to leave the Terminal Emulator open while `walletd` it is running. If you close the command prompt window, `walletd` stop.
-{% endhint %}
-
-
walletd Login UI
-
-Enter your `API password` you created in the previous step to unlock `walletd`.
-
-{% hint style="success" %}
-Congratulations on successfully setting up `walletd` and taking a significant step towards storing data on the Sia network.
-{% endhint %}
-
-## Updating
-
-New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
-
-To update:
-
-1. Download the latest version of `walletd` from the [official website.](https://sia.tech/wallet)
-2. Stop the `walletd` service with `Crtl+C`.
-3. Unzip and replace `walletd` with the new version.
-4. Restart `walletd`.
diff --git a/wallet/setting-up-walletd/linux/README.md b/wallet/setting-up-walletd/linux/README.md
new file mode 100644
index 0000000..bc3c2d0
--- /dev/null
+++ b/wallet/setting-up-walletd/linux/README.md
@@ -0,0 +1,21 @@
+---
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Linux
+
+`walletd` can be run as a background service to manage one or more Sia wallets and track their balances on the Sia network. This guide will walk you through the process of installing and configuring `walletd` on a Linux machine. We recommend using a Debian-based distribution, such as Ubuntu or Debian, but `walletd` should work on any modern Linux distribution. The setup guides in these docs are primarily focused on installing using `apt`, but `walletd` can also be installed as a binary manually or run in a Docker container.
+
+- [Debian](debian.md)
+- [Ubuntu](ubuntu.md)
+- [Other Distros](other.md)
diff --git a/wallet/setting-up-walletd/linux/debian.md b/wallet/setting-up-walletd/linux/debian.md
new file mode 100644
index 0000000..3f75205
--- /dev/null
+++ b/wallet/setting-up-walletd/linux/debian.md
@@ -0,0 +1,146 @@
+---
+description: Setup a new wallet on Debian
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Debian
+
+This guide will walk you through setting up `walletd` on Linux. At the end of this guide, you should have the following:
+
+* Installed the `walletd` software
+* Created a `walletd` wallet
+
+---
+
+## Pre-requisites
+
+To ensure you will not run into any issues with running `walletd` it is recommended your system meets the following requirements:
+
+* **Operating System Compatibility:** `walletd` is supported on the following Debian versions:
+ - Trixie (Debian 13)
+ - Bookworm (Debian 12)
+ - Bullseye (Debian 11)
+
+* **System Updates:** Ensure that Debian is up to date with the latest system updates, these updates can contain important security fixes and improvements.
+
+* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
+ - A quad-core CPU
+ - 8GB of RAM
+ - 256 GB SSD for `walletd`
+
+* **Network Access:** `walletd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
+
+## Install `walletd` Using the `apt` repository
+
+Before you install `walletd` for the first time on a new machine, you need to set up the Sia `apt` repository. Afterward, you can install and update `walletd` using `apt`.
+
+{% hint style="warning" %}
+Your system will need to have `curl` installed as well. You can check if it is installed by running `curl --version`. If it is not installed, you can install it by running `sudo apt update && sudo apt install curl`
+{% endhint %}
+
+**1. Set up the Sia `apt` repository by copying and pasting the following commands into your terminal:**
+
+```sh
+sudo curl -fsSL https://linux.sia.tech/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/siafoundation.gpg
+sudo chmod 644 /usr/share/keyrings/siafoundation.gpg
+echo "deb [signed-by=/usr/share/keyrings/siafoundation.gpg] https://linux.sia.tech/debian $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee /etc/apt/sources.list.d/siafoundation.list
+sudo apt update
+```
+
+{% hint style="info" %}
+If you use a derivative distro, such as Kali Linux, you may need to substitute the part of this command that prints the version codename with the corresponding Debian release:
+
+```sh
+$(. /etc/os-release && echo "$VERSION_CODENAME")
+```
+
+Replace this part with the codename of the corresponding Debian release, such as bookworm.
+{% endhint %}
+
+**2. Install `walletd`**
+```sh
+sudo apt install walletd
+```
+
+**3. Verify `walletd` was installed successfully**
+
+Run the following command to see the version of `walletd` that was installed:
+
+```sh
+walletd version
+```
+
+## Configure `walletd`
+
+After installing `walletd`, you will need to set a password to unlock the web interface. There is an interactive configuration process that you can start by running the following command.
+
+```sh
+sudo walletd config
+```
+
+This will start an interactive configuration process. You will be asked to verify the data directory, set a password to unlock the web interface, and optionally configure advanced settings such as the index mode.
+
+{% hint style="info" %}
+`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 %}
+
+{% hint style="info" %}
+You will not see anything when you type in your unlock password. Press enter after typing it.
+{% endhint %}
+
+## Start `walletd`
+
+Now that you have installed and configured `walletd`, you can start it by running the following command:
+
+```sh
+sudo systemctl enable --now walletd
+```
+
+## Verify `walletd` has started successfully
+
+Run the following command to verify the `walletd` service has started successfully:
+
+```sh
+sudo systemctl status walletd
+```
+
+## Updating `walletd`
+
+New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
+
+**To update:**
+
+1. Stop the `walletd` service.
+```sh
+sudo systemctl stop walletd
+```
+
+2. Upgrade `walletd` using the `apt` package manager.
+```sh
+sudo apt update
+sudo apt upgrade walletd
+```
+
+3. Start `walletd` service.
+```sh
+sudo systemctl start walletd
+```
+
+## Next Steps
+
+Now that you have `walletd` installed and running, you can start using it to manage your wallets 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 `walletd` on a remote machine or a server, you will need to create an SSH tunnel to access the web interface.
+
+
+
+- [Your Sia Wallet](../../wallet-overview.md)
+- [Transferring Siacoins](../../transferring-siacoins.md)
diff --git a/wallet/setting-up-walletd/linux/other.md b/wallet/setting-up-walletd/linux/other.md
new file mode 100644
index 0000000..2f585e9
--- /dev/null
+++ b/wallet/setting-up-walletd/linux/other.md
@@ -0,0 +1,174 @@
+---
+description: Setup a new wallet on Linux
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Linux
+
+This guide will walk you through setting up `walletd` on Linux. At the end of this guide, you should have the following:
+
+* Installed Sia `walletd` software
+* Functional `walletd` Node
+* Created a `walletd` wallet
+
+## Pre-requisites
+
+To ensure you will not run into any issues with running `walletd` it is recommended your system meets the following requirements:
+
+* **Operating System Compatibility:** `walletd` is supported on the following Linux versions:
+ - Trixie (Debian 13)
+ - Bookworm (Debian 12)
+ - Bullseye (Debian 11)
+ - Plucky (Ubuntu 25.04)
+ - Noble (Ubuntu 24.04)
+ - Jammy (Ubuntu 22.04)
+
+* **System Updates:** Ensure that your Linux system is up to date with the latest system updates, as these updates can contain important security fixes and improvements.
+
+* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
+ - A quad-core CPU
+ - 8GB of RAM
+ - 256 GB SSD for `walletd`
+
+* **Network Access:** `walletd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
+
+## Install `walletd`
+
+Download the latest version of `walletd` for your operating system from the [official website](https://sia.tech/software/walletd). For this guide, we'll be downloading the Linux version of `walletd`.
+
+1. Open a terminal and download the latest version of `walletd` for your operating system.
+
+{% tabs %}
+{% tab title="AMD64" %}
+```console
+wget https://sia.tech/downloads/latest/walletd_linux_amd64.zip
+```
+{% endtab %}
+
+{% tab title="ARM64" %}
+```console
+wget https://sia.tech/downloads/latest/walletd_linux_arm64.zip
+```
+{% endtab %}
+{% endtabs %}
+
+2. Now that we have downloaded `walletd`, we can unzip and extract the `walletd` binary to our `/usr/local/bin` directory
+
+{% tabs %}
+{% tab title="AMD64" %}
+```console
+unzip -j walletd_linux_amd64.zip walletd &&\
+sudo mv -t /usr/local/bin walletd &&\
+rm -rf walletd_linux_amd64.zip
+```
+{% endtab %}
+
+{% tab title="ARM64" %}
+```console
+unzip -j walletd_linux_arm64.zip walletd &&\
+sudo mv -t /usr/local/bin walletd &&\
+rm -rf walletd_linux_arm64.zip
+```
+{% endtab %}
+{% endtabs %}
+
+3. Create a new folder called `walletd`. This will hold all the runtime files `walletd` generates and uses.
+
+ ```console
+ mkdir /path/to/walletd/folder
+ ```
+
+## Configuring `walletd`
+
+{% hint style="info" %}
+`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.
+
+ ```console
+ cd /path/to/walletd/folder
+ walletd config
+ ```
+
+## Start `walletd`
+
+1. Once you have completed the configuration wizard, you can now start `walletd`.
+
+ ```console
+ cd /path/to/walletd/folder
+ walletd
+ ```
+
+## Accessing the UI
+
+For users with a desktop environment, you can open a browser to `http://localhost:9980` to access the `walletd` UI.
+
+If you do not have a desktop environment:
+
+1. Find your server's LAN IP using `ip addr`, `ifconfig`, etc.
+2. Switch to another computer in your LAN and open the browser
+3. Type your LAN IP followed by `:9980` in the address bar (e.g. `http://192.168.1.50:9980`)
+
+
+
+## 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.
+
+**To update:**
+
+1. Stop `walletd`.
+2. Download the latest version of `walletd`.
+{% tabs %}
+{% tab title="AMD64" %}
+```console
+wget https://sia.tech/downloads/latest/walletd_linux_amd64.zip
+```
+{% endtab %}
+
+{% tab title="ARM64" %}
+```console
+wget https://sia.tech/downloads/latest/walletd_linux_arm64.zip
+```
+{% endtab %}
+{% endtabs %}
+
+3. Unzip and replace `walletd` with the new version.
+{% tabs %}
+{% tab title="AMD64" %}
+```console
+unzip -j walletd_linux_amd64.zip walletd &&\
+sudo mv -t /usr/local/bin walletd &&\
+rm -rf walletd_linux_amd64.zip
+```
+{% endtab %}
+
+{% tab title="ARM64" %}
+```console
+unzip -j walletd_linux_arm64.zip walletd &&\
+sudo mv -t /usr/local/bin walletd &&\
+rm -rf walletd_linux_arm64.zip
+```
+{% endtab %}
+{% endtabs %}
+
+4. Start `walletd`.
+ ```console
+ cd /path/to/walletd/folder
+ walletd
+ ```
+
+{% hint style="success" %}
+Congratulations, you have successfully updated your version of `walletd`!
+{% endhint %}
diff --git a/wallet/setting-up-walletd/linux/ubuntu.md b/wallet/setting-up-walletd/linux/ubuntu.md
new file mode 100644
index 0000000..03f58bd
--- /dev/null
+++ b/wallet/setting-up-walletd/linux/ubuntu.md
@@ -0,0 +1,136 @@
+---
+description: Setup a new wallet on Ubuntu
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: true
+---
+
+# Ubuntu
+
+This guide will walk you through setting up `walletd` on Linux. At the end of this guide, you should have the following:
+
+* Installed the `walletd` software
+* Created a `walletd` wallet
+
+---
+
+## Pre-requisites
+
+To ensure you will not run into any issues with running `walletd` it is recommended your system meets the following requirements:
+
+* **Operating System Compatibility:** `walletd` is supported on the following Ubuntu versions:
+ - Plucky (Ubuntu 25.04)
+ - Noble (Ubuntu 24.04)
+ - Jammy (Ubuntu 22.04)
+
+* **System Updates:** Ensure that Ubuntu is up to date with the latest system updates, these updates can contain important security fixes and improvements.
+
+* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
+ - A quad-core CPU
+ - 8GB of RAM
+ - 256 GB SSD for `walletd`
+
+* **Network Access:** `walletd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
+
+## Install `walletd` Using the `apt` repository
+
+Before you install `walletd` for the first time on a new machine, you need to set up the Sia `apt` repository. Afterward, you can install and update `walletd` using `apt`.
+
+{% hint style="warning" %}
+Your system will need to have `curl` installed as well. You can check if it is installed by running `curl --version`. If it is not installed, you can install it by running `sudo apt update && sudo apt install curl`
+{% endhint %}
+
+**1. Set up the Sia `apt` repository by copying and pasting the following commands into your terminal:**
+
+```sh
+sudo curl -fsSL https://linux.sia.tech/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/siafoundation.gpg
+sudo chmod 644 /usr/share/keyrings/siafoundation.gpg
+echo "deb [signed-by=/usr/share/keyrings/siafoundation.gpg] https://linux.sia.tech/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee /etc/apt/sources.list.d/siafoundation.list
+sudo apt update
+```
+
+**2. Install `walletd`**
+```sh
+sudo apt install walletd
+```
+
+**3. Verify `walletd` was installed successfully**
+
+Run the following command to see the version of `walletd` that was installed:
+
+```sh
+walletd version
+```
+
+## Configure `walletd`
+
+After installing `walletd`, you will need to set a password to unlock the web interface. There is an interactive configuration process that you can start by running the following command.
+
+```sh
+sudo walletd config
+```
+
+This will start an interactive configuration process. You will be asked to verify the data directory, set a password to unlock the web interface, and optionally configure advanced settings such as the index mode.
+
+{% hint style="info" %}
+`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 %}
+
+{% hint style="info" %}
+You will not see anything when you type in your unlock password. Press enter after typing it.
+{% endhint %}
+
+## Start `walletd`
+
+Now that you have installed and configured `walletd`, you can start it by running the following command:
+
+```sh
+sudo systemctl enable --now walletd
+```
+
+## Verify `walletd` has started successfully
+
+Run the following command to verify the `walletd` service has started successfully:
+
+```sh
+sudo systemctl status walletd
+```
+
+## Updating `walletd`
+
+New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
+
+**To update:**
+
+1. Stop the `walletd` service.
+```sh
+sudo systemctl stop walletd
+```
+
+2. Upgrade `walletd` using the `apt` package manager.
+```sh
+sudo apt update
+sudo apt upgrade walletd
+```
+
+3. Start `walletd` service.
+```sh
+sudo systemctl start walletd
+```
+
+## Next Steps
+
+Now that you have `walletd` installed and running, you can start using it to manage your wallets 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 `walletd` on a remote machine or a server, you will need to create an SSH tunnel to access the web interface.
+
+
+
+- [Your Sia Wallet](../../wallet-overview.md)
+- [Transferring Siacoins](../../transferring-siacoins.md)
diff --git a/wallet/setting-up-walletd/macos.md b/wallet/setting-up-walletd/macos.md
index f3843ae..533af85 100644
--- a/wallet/setting-up-walletd/macos.md
+++ b/wallet/setting-up-walletd/macos.md
@@ -1,4 +1,5 @@
---
+description: Setup a new wallet on macOS
layout:
title:
visible: true
@@ -12,95 +13,108 @@ layout:
visible: true
---
-# macOS
+# macOS Desktop App: `walletd`
-This guide will walk you through setting up `walletd` on macOS. At the end of this guide, you should have the following:
+The `walletd` desktop app provides a user-friendly web UI to manage your Sia wallets. By the end of this guide, you will have:
-* Installed Sia `walletd` software
+* Installed the `walletd` desktop application.
* Created a `walletd` wallet
## Pre-requisites
To run `walletd` on macOS, your system should meet the following specifications:
+* **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.
+
* **Hardware Requirements:** A stable setup that meets the following specifications is recommended.
- A quad-core CPU
- 8GB of RAM
- 256 GB SSD for `walletd`
-* **System Updates:** Ensure that your macOS is up to date with the latest system updates, as these updates can contain important security fixes and improvements.
-
* **Network Access:** `walletd` interacts with the Sia network, so you need a stable internet connection and open network access to connect to the Sia blockchain.
-## Getting `walletd`
+## Download
{% hint style="warning" %}
-Remember to check which version to download to ensure it works correctly with your operating system. To do this, click on the Apple icon in the top left corner of your toolbar, then click on **About This Mac**. If the processor/chips says:
+Remember to check which version to download to ensure it works correctly with your hardware. To do this, click on the Apple icon in the top left corner of your toolbar, then click on **About This Mac**. If the processor/chip says:
-* **Intel** - `MacOS AMD64`
-* **M1 or M2** - `MacOS ARM64`
+* **Intel** - `macOS AMD64`
+* **Apple silicon (M1, M2, M3, …)** - `macOS ARM64`
{% endhint %}
-1. Download the latest version of `walletd` for your operating system from the [official website](https://sia.tech/software/walletd). For this guide, we'll be downloading the macOS version of `walletd` .
-2. Now that we have downloaded `walletd`, you may need to unzip it.
- * Double-click the downloaded `walletd` zip file to unzip it if it hasn't done so automatically.
- * Click on the newly unzipped directory.
- * Right-click on the path bar at the bottom of the Finder window and click **Open in Terminal**.
-3. In the opened terminal window, move the `walletd` binary to `/usr/local/bin` by running the following command and press enter:
+1. Go to [Sia Software Downloads](https://sia.tech/software-downloads). Here you can find the latest software downloads for all our daemons.
-```sh
-sudo mv walletd /usr/local/bin
-```
+
-{% hint style="info" %}
-You'll be prompted to authorize this action by providing your system password. Type this in and press enter to continue.
+2. From the dropdown menu, select **macOS ARM64** or **macOS AMD64** depending on your hardware.
+
+{% hint style="warning" %}
+Before proceeding with downloading, please read our [Terms of Service](https://sia.tech/terms-of-service). Once you have reviewed and are satisfied, check the box to agree.
{% endhint %}
-4. Finally, for good practice, create a folder on the home drive. This folder will be utilized specifically to store data related to the `walletd` software.
+3. Click **Download** to get the latest `walletd` version for your hardware.
-```sh
-mkdir ~/walletd
-```
+## Run
-## Running `walletd`
+After downloading the `walletd` desktop application:
-1. Run the following in your terminal command to start `walletd`:
+1. **Install the app:** Open the downloaded `.dmg` and drag the `walletd` app into your **Applications** folder.
-
walletd
-
+
-You will be prompted to input a `API password`. You choose this password, which can be anything you want. It will be used to unlock the `walletd` UI, via your browser, should be something secure and easy to remember. This value is not stored anywhere; you will need to re-enter it every time you start `walletd`.
+2. **Launch the app:** Open `walletd` from your Applications folder or Launchpad like any other program.
+3. **Initial setup *(first-time users only)*:** On first launch, the Welcome to `walletd` window will guide you to set a password to access the web UI. After entering your desired `API password`, `walletd` will start.
-{% hint style="info" %}
-You can also set the SIA`_API_PASSWORD` environment variables so you do not have to re-enter the values every time.
-{% endhint %}
+
-2. After entering your desired `API password`, `walletd` will start.
+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.
-
Starting walletd
+{% 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.
+{% endhint %}
-3. You can now access the `walletd` UI by opening a browser and going to `http://localhost:9980`.
+
-{% hint style="warning" %}
-Remember to leave the terminal window open while `walletd` is running. If you close the command prompt window, `walletd`will stop.
+{% hint style="success" %}
+**Success!** `walletd` is now running on your Mac, and you’re ready to start managing your wallets on the Sia network.
{% endhint %}
-
walletd
+## Configure
-Enter your `API password` you created in the previous step to unlock `walletd`.
+You can customize `walletd` through the desktop app, which provides full control over all available settings, from wallet indexing to batch sizing and more.
-{% hint style="success" %}
-Congratulations on successfully setting up `walletd` and taking a significant step towards securing your Siacoins.
+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.
+
+
+
+There are several configurable settings in `walletd`. Below is a breakdown of what each setting does:
+
+| Field | Description |
+|------|-------------|
+| Password | Set or update your wallet password |
+| Automatically open the Web UI on startup | Enable this to launch the interface when `walletd` starts |
+| Data Directory | Where `walletd` stores its data and config files |
+| HTTP Address | Local address for the Web UI |
+| Log Level | Amount of detail in logs |
+| Index Mode | Indexing scope of either `personal` (your addresses), `full` (entire chain), or `none` (read-only). |
+| Index Batch Size | Number of blocks processed per batch during indexing |
+| Consensus Network | Connect to either `mainnet` (live network) or `zen` (test network) |
+| Syncer Gateway Address | Address for connecting to a gateway node for syncing (optional) |
+| Syncer Bootstrap | Enable for discovering and syncing with the network |
+| Syncer Enable UPnP | Enable Universal Plug and Play (UPnP) to automatically configure router port forwarding for incoming connections |
+
+{% hint style="warning" %}
+Always **save and restart daemon** after making configuration changes to ensure they are applied.
{% endhint %}
-## Updating
+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.
-It is imperative to keep your host up to date. New versions of `walletd` are released regularly and contain bug fixes and performance improvements.
+## Update
-To update:
+`walletd` updates regularly with bug fixes, performance improvements, and new features. Updating your node ensures stability and compatibility with the Sia network.
-1. Download the latest version of `walletd` from the [official website](https://sia.tech/software/walletd).
-2. Stop the `walletd` service with `Cmd+C`.
-3. Unzip and replace `walletd` with the new version
-4. Restart `walletd`.
+On macOS, the app downloads updates automatically and notifies you when they’re ready. Simply 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.
+{% endhint %}
