Site routes
Publish a site prefix through a Linux device so other devices can reach it through the overlay.
Use cases
A site route binds a site LAN IPv4 prefix to a Linux device. Other desktop, server and mobile devices can then reach that prefix through WideWired.
Creating a route
Under Configuration → Routes, configure:
- Device: an approved, online Linux device directly connected to the target network.
- Site prefix: the canonical IPv4 CIDR to advertise.
- Next hop: a unicast IPv4 address reachable by the Linux device.
- Advertise: publish the route after the selected device applies it successfully.
Reading effective state
Check the Readiness column. Effective means that other devices can use the site prefix. When a route is not effective, follow the reason shown on the page.
Overlap with forwarding
Conditional forward rules enable Override site routes by default. Disable it when traffic matching both a forward rule and a site route should continue to use the site device.
Quick troubleshooting
| Symptom | Check and action |
|---|---|
| The target device is missing from the selector | Confirm that it runs Linux, is approved and is currently online |
| The route remains non-effective | Confirm that Advertise is enabled and the selected device has applied the latest configuration; inspect the readiness reason and device health |
| Other devices cannot reach the site prefix | Confirm that the route is effective, then check next-hop reachability, the site firewall and the return route |
| Overlapping traffic uses the forward exit | Edit the matching forward rule and disable Override site routes |
| An old connection remains after route deletion | New connections use the current routes; close and re-establish the old connection before testing again |