โ† All blog posts

Distributed hosting

Mirror failover

When an eligible, healthy, integrity-matching mirror exists, ForkMesh can fail over behind the same public URL. Sticky routing keeps a clone exchange on one mirror.

Feature 05 of 72FeatureDistributed hosting & preservation3 min read
Abstract ForkMesh artwork for Mirror failover

Why it matters

Mirror failover gives ForkMesh a concrete mechanism for keeping the same repository URL during a source outage when a verified candidate is available. If no eligible mirror is online, the request fails clearly rather than implying guaranteed availability.

Code disappears from a network when one hosted account, one VM, or one storage path becomes the only way to reach it. In ForkMesh, mirror failover addresses that need at the feature level, keeping the behavior close to the repository instead of buried in a detached hosted layer.

How ForkMesh handles it

ForkMesh handles failover through a fresh eligible set scoped to the same signed repository state. Candidates must have an account-bound endpoint, a recent successful challenge, matching integrity proof, no active abuse block, and the required read operations.

The Worker prefers suitable region and observed latency, uses a bounded cursor for fair selection, and keeps a clone exchange sticky to one mirror. If an origin becomes unavailable before a response is committed, it can choose another verified candidate without redirecting the client or storing the repository.

Title focus: Mirror failover stays tied to the same repository URL surviving host outages by moving traffic to a healthy mirror and the local-first repository model.

Where it fits

Use mirror failover when availability, clone routing, and preservation need to be handled by the mesh instead of by a single origin.

It pairs with the rest of Distributed hosting & preservation because Mirror failover keeps the same repository URL surviving host outages by moving traffic to a healthy mirror connected to the repository, its signatures, and the nodes that serve it.