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.

Grab the installer for your platform from the download page. Builds are not code-signed yet, so Windows SmartScreen and macOS Gatekeeper will warn that the publisher is unverified — that’s expected. Verify the SHA-256 checksum published next to each download to confirm the file matches what we shipped.

OS Status
Windows Installer available. Not code-signed — SmartScreen will warn.
macOS Build available for Apple silicon. Not code-signed — Gatekeeper will warn. Intel is not supported.
Linux x86_64 build available, plus a Debian package for apt.

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.