# Bring a Stormbox online

> After your installer wires a Stormbox, claim it for its machine in the MonsoonOS admin, connect it to Wi-Fi, switch it on and send a test.

- Part of: MonsoonOS Guide › Locations, machines and Stormboxes
- Available on every MonsoonOS plan: Full Wash Platform and Rain Pay Terminals Only.
- You need a Stormbox.
- Who can do this: On Full Wash, anyone whose role includes "Set up machines" (Owner by default). On Terminals Only, your admin login.
- Last updated: 2026-11-17
- Web page: https://www.cactuswashsystems.com/guide/bring-a-stormbox-online

A Stormbox connects a machine to MonsoonOS, so a payment, the app or your team can start it. Your installer mounts and wires the Stormbox, following the install sheet that comes with the hardware. This article covers your part in the MonsoonOS admin: claiming the Stormbox for its machine, connecting it to Wi-Fi, switching it on and testing it.

## Before you start

- The machine added in **Machines**. See [Add a machine](https://www.cactuswashsystems.com/guide/add-a-machine).
- The Stormbox installed, wired and powered on by your installer.
- The Stormbox's **serial number**, printed on its label.
- The name and password of the site's 2.4 GHz Wi-Fi network, if the Stormbox will use Wi-Fi.

## Open the Configure Stormbox page

1. Go to **Operations › Machines**. With several locations, choose one from **Location** at the top of the page to see only its machines.
2. On the machine's row, select **Configure**.

The **Configure Stormbox** page for that machine opens. You can also reach it from the Setup Guide: the **Bring your Stormboxes online** step lists every machine with a **Configure Stormbox** button.

## Claim the Stormbox

1. Under **Stormbox Link**, type the serial number from the Stormbox's label.
2. Select **Claim**.

A message confirms the Stormbox is claimed and linked to this machine. **Stormbox Link** now shows the Stormbox's status, its serial number and **Last contact**.

One Stormbox can run several machines. For the second machine on the same Stormbox, choose the Stormbox from the **Select a claimed Stormbox…** list instead, then select **Assign**.

## Connect it to Wi-Fi

Once the Stormbox is claimed, a **Wi-Fi** card shows its connection, its **Network** and the machines it runs. A new Stormbox with a cellular backup comes online over cellular by itself, so you can set its Wi-Fi from here.

1. In the **Wi-Fi** card, select **Set up Wi-Fi**. If a network is already set, the button says **Change Wi-Fi**.
2. Type the **Network name** exactly as it appears, capital letters and spaces included.
3. Type the Wi-Fi **Password**, then type it again in **Confirm password**. Tick **Show password** to check what you typed.
4. Select **Continue**.
5. Read the summary. The Stormbox restarts and is offline for about 2 to 5 minutes, and its machines cannot start a wash until it is back.
6. Select **Restart and join**.

The card shows progress while the Stormbox joins. When it is done, the card shows **Online** and the new network.

> **Note:** The Stormbox joins 2.4 GHz networks only. Guest networks with a sign-in page and company logins do not work.

## Switch it on and save

1. Turn on **Stormbox Enabled**. When it is on, the machine is in service for customers. When it is off, the machine is out of service and hidden from customers.
2. Select **Save Configuration**.

**Stormbox configuration saved.** appears at the bottom right. The wiring settings lower on the page are filled in by your installer from the install sheet. Leave them as they are. A count-down bay, whose own timer counts the wash down, has a few settings of its own: see [Set up a count-down bay](https://www.cactuswashsystems.com/guide/set-up-a-count-down-bay).

## Test the machine

1. Make sure the bay is clear.
2. Select **Test Pulse**. On an in-bay automatic the button says **Test Wash Start** and starts a real wash, so MonsoonOS asks you to confirm first.
3. Watch the machine start.

A message at the bottom right confirms the test was sent. **Test Connection** checks that MonsoonOS is ready to send commands to the Stormbox. To see when the Stormbox itself last reported, read **Last contact** under **Stormbox Link**.

When the test works, the machine is ready to sell. Pair its terminal next: [Pair an Experience terminal](https://www.cactuswashsystems.com/guide/pair-an-experience-terminal) or [Register an MDB card reader](https://www.cactuswashsystems.com/guide/register-an-mdb-card-reader).

## Emergency Stop Lockout

**Emergency Stop Lockout** is the number of seconds a machine stays locked after a team member uses Emergency Stop on a running wash, so a stray signal cannot restart it straight away. It is 10 seconds unless you change it, and can be 0 to 300. Select **Save Configuration** after changing it. See [Lock, unlock and force-stop a machine](https://www.cactuswashsystems.com/guide/lock-unlock-and-force-stop).

## Track progress in the Setup Guide

In the Setup Guide step **Bring your Stormboxes online**, each machine shows **Claimed**, **Enabled** and **Relays assigned**. **Relays assigned** turns green once your installer has saved the wiring settings. The step is done when every machine is claimed and enabled. For a machine that has no Stormbox, select **No Stormbox**.

> **If Claim says no Stormbox was found with that key:** Check the serial number on the label again, character by character, and type it exactly. If it still fails, email support@cactuswashsystems.com with the serial number.

> **If Claim says the Stormbox is already claimed by another organization or has been disabled:** Email support@cactuswashsystems.com with the serial number. Do not try a different Stormbox's number.

> **If Test Pulse is greyed out:** Turn on **Stormbox Enabled** and select **Save Configuration** first.

> **If the test says MonsoonOS could not reach the Stormbox to send the test:** Check that the Stormbox has power and shows **ONLINE** under **Stormbox Link**, then try again. See [A machine or Stormbox is offline](https://www.cactuswashsystems.com/guide/machine-or-stormbox-offline).

> **If Test Connection says MonsoonOS could not open its connection to this Stormbox:** Try again in a minute. If it keeps failing, email support@cactuswashsystems.com with the serial number.

> **If the test says No relay profile assigned to this machine:** The wiring settings have not been saved yet. Ask your installer to finish them.

> **If Restart and join is greyed out:** A wash is running on one of the Stormbox's machines; wait for it to finish. The Stormbox also needs 5 minutes after a restart before its Wi-Fi can be changed, and the card shows how long until you can make another change.

> **If the Stormbox cannot join the network:** If it has a cellular backup, it comes back online over cellular. Check the name and password, then select **Try again**, or select the button to go back to the network it used before.

> **If the Wi-Fi card says to contact support, or there is no Wi-Fi card:** Some Stormboxes cannot have their Wi-Fi changed from the admin. Email support@cactuswashsystems.com with the serial number.

> **If you claimed the Stormbox for the wrong machine:** Email support@cactuswashsystems.com before you change anything. **Unclaim Stormbox** takes the machine out of service, and if no other machine uses that Stormbox, it releases the Stormbox from your account.

> **If you see the Wi-Fi card but no Set up Wi-Fi button:** Your role does not include **Change Stormbox Wi-Fi**. Ask your owner.
