SpotWarp v3.5.2 Setup Guide for SaladCloud (C-Binary & PyPI)

Get SpotWarp running in 1 minute

Three simple steps. Your SaladCloud API key stays 100% local — never uploaded.

1

Install SpotWarp

1-line universal installer (Zero-Python required)

Run the 1-liner installer or download standalone C-binaries. Python is 100% optional — our standalone binaries run with zero dependencies.

Linux / macOS (1-Liner)
curl -fsSL https://gpu-action.com/install.sh | bash
Windows PowerShell (1-Liner)
irm https://gpu-action.com/install.ps1 | iex
Linux x86_64 (13MB) macOS Apple Silicon (6MB) Windows x64 ZIP (6MB)

Windows users: Download the ZIP, extract it, and run .\spotwarp.exe init in that folder — no installer and no admin rights needed. The binary is not code-signed yet, so SmartScreen may warn on first run: choose More info → Run anyway. You can verify the file first against the published SHA256 checksum.

Standard Python pip (Any OS / Docker)
pip install --upgrade spotwarp

Using the Vast.ai template? Releases 3.5 and later protect SaladCloud only. SpotWarp 3.4.3 is the last release with Vast.ai support, so install that version for Vast.ai: pip install spotwarp==3.4.3

2

Activate License & SaladCloud Key

1-minute local config

Run the setup wizard. It asks for your SpotWarp License Key (from your receipt email; press Enter for the built-in 14-day evaluation mode), your SaladCloud API key, your organization name and your project name. Values already set in SALAD_API_KEY and SALAD_ORG are picked up automatically:

terminal (any OS)
spotwarp init
✨ Direct 1-Line Start: You can also pass your license key directly on daemon launch:
spotwarp start --license-key spw_live_your_key_here -d
3

Start the SaladCloud Guard

instant protection

Run in the foreground or detach as a 24/7 background daemon with -d.

Option A: Foreground Live Console
spotwarp start
Option B: 24/7 Background Daemon
spotwarp start -d
💡 Training Auto-Resume: To automatically resume training on replacement GPUs, add:
spotwarp start -d --resume-cmd "python3 /workspace/train.py --resume"
🔁 Warm standby (on by default): SpotWarp keeps your container group at 2 replicas so a second node is already running. SaladCloud bills the second replica like any other. To skip it:
spotwarp start -d --no-standby
4

Daemon Management & Status

cli commands
Check Status
spotwarp status
Stop Daemon
spotwarp stop
5

Console Output Decoder

what you see
License Verified: Active
GoodYou're authenticated and the guard is running.
[Tracked] SaladCloud Container …
GoodYour running SaladCloud instance was found. Backups to your machine have started.
Protected Containers: 0
NormalNo running instance found in your SaladCloud project yet.
SALAD NODE PREEMPTION DETECTED
ActionYour node was lost. SpotWarp is waiting for the replacement node, then restores your files.
?

Troubleshooting

You seeIt means
status 401License key mistyped or concatenated with another key — re-copy it as one piece.
Protected Containers: 0SALAD_API_KEY or SALAD_ORG isn't set in this window, or the project name is wrong — re-run step 2 here.
export errorYou're in PowerShell — use $env: instead.
backups missingCheck .\backups\<container_group_name>\, or your --backup-dir path.