Documentation
Complete guides for installing and configuring your Boat & Rv Guardian ecosystem.
Physical Installation Best Practices
When setting up your smart water valve for a Boat or RV, physical placement is just as important as the software itself. To maximize safety and prevent catastrophic water damage, it is highly recommended to install the smart valve directly at the source spigot, rather than inside your vehicle or on the vehicle's water inlet.
The Ideal Configuration
- Source Spigot (Campsite/Marina water source)
- Smart Water Valve (LinkTap Gateway, attached directly to the spigot)
- Water Hose (Connects the valve to the RV/Boat)
- RV/Boat City Water Inlet
Why Place the Valve at the Source?
Many owners make the mistake of installing pressure regulators, filters, and smart valves directly onto the water inlet on the side of their RV. This leaves the water hose completely unprotected.
Water hoses are exposed to UV rays, physical wear, and fluctuating campsite water pressures. If a hose bursts while you are away, water will spray continuously. If your smart valve is inside the RV or attached to the inlet, it cannot stop a leak happening before the valve.
Benefits of Source-Spigot Installation
- Complete Hose Protection: If the hose ruptures, the valve detects the abnormal continuous flow and shuts off the water at the source.
- Internal Plumbing Protection: It still provides full protection for all internal plumbing inside your RV or Boat.
- Reduced Weight on Inlet: Smart valves and gateways can be heavy. Keeping the weight on the sturdy metal campsite spigot prevents structural damage to your vehicle's plastic fittings.
Additional Tips
- Pressure Regulator: Place it after the smart valve to protect your hose from high-pressure spikes.
- Support the Valve: If your setup is heavy (e.g., adding Y-splitters), use a hose support stand to take weight off the spigot.
Shelly Flood Sensor Webhooks
To ensure your standalone Shelly Flood sensors instantly trigger the LinkTap shutoff valve, configure the webhook in the sensor's Web Admin interface:
- Connect the Shelly sensor to your local Wi-Fi.
- Open the sensor's Web Admin interface in your browser.
- Navigate to Actions / Webhooks.
- Set the condition to trigger when water is detected.
- Set the URL to point to your dashboard's local API (e.g.,
http://<YOUR_COMPUTER_IP>:3030/api/webhook/flood). - Make sure it uses the POST method.
Whenever the sensor detects a leak, it fires this webhook, instantly triggering the Guardian app to close the main valve.
How it connects
Local Network (Boat/RV Router)
📱 Your Phone/Laptop ↔ 📡 LinkTap Gateway ↔ 💧 Smart Valve
Cloud Alerts (When you are away)
🌊 Shelly Flood Sensor → ☁️ Cloudflare Worker → 🔔 Firebase Push Notification & 💧 LinkTap API Shutoff