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.
Download
Section titled “Download”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. |
First launch
Section titled “First launch”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.