Skip to content

Install CrossXCloud

CrossXCloud runs as a desktop app on Windows, macOS, and Linux. The app is a self-contained native window with a Go backend and an embedded React frontend.

Signed installers and download links are coming. Until then, you can run CrossXCloud from source by cloning the desktop app repository and following its build instructions.

OS Status
Windows Builds and runs from source. Signed installer coming.
macOS Builds and runs from source. Signed installer coming.
Linux Builds and runs from source. Signed installer coming.

The first time you open CrossXCloud, you are asked to create a vault.

The vault is a passphrase-sealed key identity. It lives on your machine and guards the keys used to encrypt your cloud credentials. You pick a passphrase at first launch; there is no recovery path if you lose it, so choose something you can keep.

After the vault is created, it is unlocked for the current session. On every later launch, you enter the same passphrase to unlock it. Nothing about your clouds is reachable until the vault is unlocked.

Vault state What it means What you can do
Uninitialized No vault file exists yet. Create the vault with a passphrase.
Locked Vault file exists, private key not in memory. Save new credentials. Cannot use existing ones.
Unlocked Private key resident in memory. Save and use credentials, run Plan and Apply.

See Security and the vault for what the passphrase actually protects and why your credentials never leave the machine.

Once the app is open and the vault is unlocked, continue to Connect a provider.