diff --git a/images/basic-backhaul-diagram.png b/images/basic-backhaul-diagram.png
new file mode 100644
index 0000000..c13a484
Binary files /dev/null and b/images/basic-backhaul-diagram.png differ
diff --git a/manage/remote-node/backhaul.mdx b/manage/remote-node/backhaul.mdx
index 412e80c..f7cc1dd 100644
--- a/manage/remote-node/backhaul.mdx
+++ b/manage/remote-node/backhaul.mdx
@@ -6,10 +6,16 @@ description: "Turn a remote node into a network concentrator that routes traffic
Site to cloud is an advanced [remote node](/manage/remote-node/understanding-nodes) configuration available in [Pangolin Cloud](https://app.pangolin.net/auth/signup).
-A standard remote node terminates WireGuard tunnels and proxies HTTP(S) traffic to your resources. A **backhaul** node goes a step further: it acts as an IP router between an entire network, such as a cloud VPC, and your Pangolin sites. Instead of just forwarding individual resource connections, the node forwards whole subnets, letting hosts on either side reach each other without installing a site on every machine.
+A standard remote node terminates WireGuard tunnels and proxies HTTP(S) traffic to your resources. A **backhaul** node goes a step further: it acts as an IP router between an entire network, such as a cloud VPC, and your Pangolin sites. Instead of just forwarding individual resource connections, the node forwards whole subnets, letting hosts on either side reach each other without needing to install site and client on every machine.
This is useful when you want to bridge a cloud network (for example, an AWS VPC) with your on-prem or office network through Pangolin, using a node running in that VPC as the concentrator.
+Another common use case is connecting edge devices to a cloud network. Edge devices can send traffic to a service in the cloud, and the cloud can send traffic down to a specific edge device. In both cases, the persistent backhaul tunnel carries the traffic.
+
+
+
+
+
Site to cloud builds on top of a normal remote node install. Read [Remote Nodes](/manage/remote-node/understanding-nodes) and [Quick Install Guide](/manage/remote-node/quick-install-remote) first if you haven't deployed a node yet.
@@ -54,7 +60,7 @@ The standard node install runs Gerbil and Traefik on a bridge network, with Trae
name: pangolin
services:
pangolin:
- image: docker.io/fosrl/pangolin-node:latest
+ image: docker.io/fosrl/pangolin-node:latest # We recommend locking to a specific version for stability.
container_name: pangolin
restart: unless-stopped
network_mode: host
@@ -124,8 +130,8 @@ server:
internal_port: 3001
internal_hostname: localhost
managed:
- id: "he4g78wevj25msf"
- secret: "n7sd18twfko0q0vrb7wyclqzbvvnx1fqt7ezv8xewhdb9s7d"
+ id: "he4g78wevj25msf" # REPLACE WITH YOUR NODE'S ID
+ secret: "n7sd18twfko0q0vrb7wyclqzbvvnx1fqt7ezv8xewhdb9s7d" # REPLACE WITH YOUR NODE'S SECRET
```
See the [configuration file reference](/manage/remote-node/config-file) for every available option.
@@ -148,7 +154,7 @@ experimental:
plugins:
badger:
moduleName: "github.com/fosrl/badger"
- version: "v1.3.1"
+ version: "v1.7.0" # Check GitHub Releases for latest version tag
log:
level: "INFO"
@@ -255,13 +261,7 @@ If you are using Newt on Windows `wintun.dll` is required to run in native mode.
## Resolving a Site's Address Directly
-If something outside of Pangolin's normal resource routing needs to reach a site directly, for example a static route configured elsewhere in your network, you can resolve `.site.pangolin.net` to get the site's current routable address.
-
-This is useful with backhaul because a site's traffic can move between exit nodes if one becomes unavailable. The DNS record always follows the site to whichever node it's currently connected through.
-
-
- Expect a short gap in resolution when a site moves between nodes while the DNS record updates.
-
+If something outside of Pangolin's normal resource routing needs to reach a site directly, for example a static route configured elsewhere in your network or a cloud service sending traffic to a specific edge device, you can resolve `.site.pangolin.net` (the site ID is the one used in the `--id` argument when running the site) to get the site's current routable address.
## High Availability