Printable field installer guide

Download Markdown Back to wizard

# Field installer guide — SUDL MikroTik edge

Use the **guided wizard** at the enroll portal whenever possible. This page is a printable backup.

## Before you start

- MikroTik with **RouterOS 7**, dual-band WiFi preferred
- Container package if you will run local Mosquitto on the device
- One-time code from SUDL ops
- Winbox installed on your laptop
- For **WiFi uplink**: site SSID and passphrase
- For **wired uplink**: Ethernet from ISP/router to MikroTik `ether1`

## Wizard overview

1. Enter the one-time code  
2. Optional board serial  
3. Choose wired or WiFi uplink (enter SSID/passphrase if WiFi)  
4. Download `.rsc` (and Mosquitto bridge conf)  
5. Follow on-screen Winbox import steps  
6. Verify WireGuard / `SUDL IoT` / hub status  

## Important SSIDs

| SSID | Purpose |
|------|---------|
| Site WiFi (your choice) | **Uplink** — internet for the MikroTik |
| `SUDL IoT` | **Local sensors** — broadcast by this MikroTik (2.4 GHz) |
| Neighbor `SUDL IoT` | **Backup uplink** if primary internet fails |

## Import (summary)

1. Connect PC to MikroTik LAN, open Winbox  
2. Files → upload `SITEID.rsc`  
3. Terminal: `/import file-name=SITEID.rsc`  
4. Attach WAN (cable or wait for WiFi station)  
5. Confirm `wg-sudl` handshake and SSID `SUDL IoT`  

## After install

- Delete the downloaded `.rsc` from your laptop (it contains secrets)  
- Ops receive ntfy events on topic `sudl-ops`  
- If the unit fails: ask ops for a **Replace** OTC and run the wizard again  

## Troubleshooting

- No DHCP on uplink → wrong cable port or wrong WiFi passphrase  
- No WireGuard handshake → UDP 51820 blocked on site firewall, or uplink still down  
- No `SUDL IoT` SSID → wireless package / radio disabled; re-check import logs