Unionvisor is an optional (and recommended) supervisor for uniond. It is a systemd service that manages the lifecycle of uniond by managing a symlink called current, and swapping this symlink to the newer uniond version when an upgrade signal occurs.
Union Bundles are directories of static binaries containing each version of uniond for a specific network (union-testnet-2, for example). They also contain a meta.json describing the bundle's structure.
Unionvisor consumes Union Bundles. When configuring Unionvisor, you provide a Union Bundle such as the bundle-testnet that is defined on our flake. When an upgrade signal occurs, Unionvisor will swap the current symlink to the newer version of uniond in the bundle.
graph
subgraph "Unionvisor (systemd service)"
home["uniond home directory"]
current[current uniond symlink]
end
subgraph "Union Testnet Bundle"
subgraph "Versions (static binaries)"
uniond-v0.8.1[uniond-v0.8.1]
uniond-v0.9.1[uniond-v0.9.1]
uniond-v0.10.1[uniond-v0.10.1]
end
meta.json[meta.json]
end
current --> uniond-v0.10.1