Getting Started

Install Sprinqua

From a fresh Raspberry Pi to a working irrigation controller in under 10 minutes.

Before you start

🍓

Raspberry Pi

Any model with GPIO pins — Pi 3, 4, 5 or Zero 2 W. Must be running Orbit OS.

Get Orbit OS →
🔌

Relay Board

A GPIO-controlled relay HAT. Sprinqua supports 8+ boards out of the box — from 3 to 8 channels.

See supported boards →
📱

Browser

Any modern browser on the same local network. No app install needed — Sprinqua is a web UI.

Installation steps

1

Install Orbit OS on your Raspberry Pi

Download the Orbit OS installer and run it on your Raspberry Pi. It sets up the OS, the app runtime, and the store in one go. After installation, the device will automatically restart.

Already have Orbit OS with a Store account? Skip to step 4 →

# Download the installer

wget https://orbit-os.org/orbit-os-26-installer.deb

# Install it

sudo dpkg -i orbit-os-26-installer.deb

Orbit OS Getting Started →
2

Open the Orbit OS Launcher in your browser

Open a browser on any device on the same network and navigate to your Raspberry Pi's address. The Orbit OS Launcher will open and ask for your username and password.

http://<YOUR_DEVICE_IP>

# Default login

User: admin

Password: admin

3

Add your Orbit OS Store account

In the launcher, click the Settings icon, go to Account, and sign in with your Orbit OS Store account. This allows you to install apps from the store.

Settings icon

Settings → Account

Sign in with your Orbit OS Store credentials to enable app installation.

4

Install Sprinqua from the Orbit OS Store

Open the Orbit OS Store and search for the Sprinqua application. Tap Install, select your device from the list, and confirm — Orbit OS will download and deploy it automatically.

Sprinqua icon

Sprinqua

Find this icon in the store and tap it to open the app page.

Get it on Orbit OS Store
5

Open Sprinqua from the launcher

Go back to the Orbit OS Device Launcher at your device's address. Sprinqua is now installed — you will see its icon in the launcher. Tap it to open the app.

http://<YOUR_DEVICE_IP>

Sprinqua icon

Sprinqua

The icon is now visible in your launcher. Tap it to open the app.

6

Run the Hardware Setup Wizard

On first launch, Sprinqua shows the setup wizard. It walks you through three quick steps:

A

Select your relay board

Pick your exact board model from the list. Sprinqua auto-fills the correct GPIO pin mapping.

B

Name your irrigation zones

Assign a name and type (sprinkler, drip, mist…) to each relay channel. Set a safety auto-off limit per zone.

C

Test each relay

Pulse each relay for 3 seconds to verify the physical wiring before committing to the configuration.

7

Start watering 💧

You're done. Turn zones on manually, create weekly schedules, enable Smart Watering to skip rainy days, or connect to Home Assistant via MQTT. All from the same clean UI.

Optional: Connect to Home Assistant

If you use Home Assistant, Sprinqua can publish all zones as MQTT switches with auto-discovery — no manual entity configuration needed.

# In Sprinqua → Settings → Enable MQTT

Broker: 192.168.1.x # your HA host

Port: 1883

Prefix: sprinqua # topic prefix

# Topics Sprinqua publishes

sprinqua/zone/1/state → ON | OFF

sprinqua/mode/state → Standalone | HA-Managed

Troubleshooting

Can't reach the web UI
Make sure your computer and the Raspberry Pi are on the same local network. Try using the device's IP address instead of the hostname. Check the Orbit OS dashboard to confirm Sprinqua is running.
Relay fires but nothing happens physically
Check that the relay board is powered (many boards need an external 5V supply in addition to GPIO). Verify that the COM/NO/NC wiring is correct for your valve type. The relay click sound confirms GPIO is working — the issue is downstream.
Wrong relay fires (GPIO mismatch)
Make sure you selected the exact board model in the wizard. Different board revisions sometimes use different GPIO layouts. Use Settings → Re-run Hardware Wizard to reconfigure. If your board isn't listed, open a board request.
Smart Watering not skipping
Confirm that Smart Watering is enabled in Settings and that your location coordinates are set. The check runs ~1 hour before a scheduled run. Open-Meteo requires internet access from the Raspberry Pi — verify the device can reach the internet.
💧

Something not working?

Open an issue on GitHub and we'll help you sort it out. Feature requests and board additions are also welcome.