Files
docs-v2/manage/resources/private/multi-site-routing.mdx
2026-08-20 16:17:51 -04:00

28 lines
2.4 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Multi-site Routing and High Availability"
description: "Use multiple sites on a private resource for resilient routing and failover"
---
When you configure a private resource, you can attach more than one site. Pangolin then chooses how to reach the resources destination through those sites, similar in spirit to running multiple connectors into the same network: traffic is steered toward whichever path is most suitable at the time.
### How Routing Works
Pangolin evaluates the sites you selected and routes client traffic through the site that is most ideal from the clients perspective. That decision weighs factors such as latency and whether the site is reachable. If a site becomes unavailable, clients begin using the next best online site without you having to reconfigure the resource.
<Note>
Failover may take a few seconds. The site must be registered as offline, routing changes propagated to clients, and only then can failover take effect, so a short gap while that happens is expected.
</Note>
You are not limited to two sites. You can select as many sites as you need on a single private resource, as long as every selected site can actually reach the resources destination on the network.
### Example: Redundant Office Connectors
Suppose your office LAN is reachable from two servers, and you install a Pangolin site connector on each. Both sites act as connectors into the same office network, so either site can route to the same internal hosts.
You create one private resource for an internal service and select both sites. While both connectors are healthy, Pangolin sends traffic through the better path. If one server or connector goes down, clients keep access to the private resource because traffic fails over to the other online site.
### Requirements and Pitfalls
Every site you attach must have routable access to the resource destination (same logical network, correct routes, DNS or IP resolution from that sites perspective, and so on). The product assumes that any site in the list is a valid path to the same destination.
If you mix sites that live on entirely different networks and one or more of them cannot reach the destination, behavior becomes unpredictable and the resource may not work reliably. Before adding a site, confirm from that sites network that it can reach the configured destination the same way you expect the primary site to.