Quickstart

Install Diversion, connect your depot, and run your first sync in under 10 minutes.

Prerequisites

  • macOS 12+, Windows 10/11, or Ubuntu 20.04+
  • Diversion account (sign up at early-access.html)
  • Network access to your existing depot or a new cloud workspace

Step 1: Install the CLI

# macOS / Linux
curl -sf https://diversionhq.org/install | sh

# Windows (PowerShell)
iwr https://diversionhq.org/install.ps1 | iex

Verify the install:

diversion --version
# diversion 0.9.1 (2025-11-10)

Step 2: Authenticate

diversion auth login
# Opens browser for OAuth flow; token stored in OS keychain

Step 3: Create or connect a workspace

# New cloud workspace
diversion workspace create my-studio --region us-west-2

# Or import from Perforce
diversion depot connect p4://perforce.studio.internal:1666

Step 4: Sync

diversion sync
# ✓ 12,847 objects synced (183 GB) in 4m 12s

Step 5: Lock a file before editing

diversion lock Content/Maps/City_Hub.umap
# ✓ City_Hub.umap locked (exclusive)

You're live. See Unreal Engine Setup to install the UE5 plugin.