Quick Start →
Help / WiFi/VPN Sync

WiFi/VPN Sync

Keep Warren in step across every Mac on your network without a server. WiFi/VPN Sync uses peer-to-peer discovery to find other devices in your office or on your company VPN and exchange the latest project data.

ℹ️
Role required: Admin — Any team member can trigger a sync, but only Admins can enable or disable the sync service in Settings.

How it works

Warren's WiFi/VPN Sync is "local-first." It doesn't rely on a central cloud or account. Instead, it uses two discovery methods:

⚠️
Last-write-wins: Warren uses a simple full-state sync. When you sync with a peer, the device with the most recent "Last Saved" timestamp becomes the authoritative state. To avoid losing work, let one person finish their changes before another starts.

Setup

1

Open Settings → WiFi/VPN Sync

Press ⌘, to open Settings, then navigate to WiFi/VPN Sync.

2

Set your Group Code

Choose a unique code for your studio (e.g. my-studio-sync) and enter it on every device. This ensures you only see your own team's devices.

3

Enable sync

Toggle Enable Local Sync to On. Warren will begin listening for peers.

Syncing data

Once enabled, Warren will show a list of Discovered Peers in the Settings panel.

  1. Find the device you want to sync with.
  2. Click the Sync button next to its name.
  3. Warren will connect, exchange data, and merge the newest projects, time logs, and tasks.

Working via VPN

If you're working remotely via a company VPN, Bonjour discovery often won't work across the tunnel. Warren solves this by publishing your local VPN IP address to your private iCloud store. As long as both devices are signed into the same Apple ID (or sharing a group code), they can find each other across the VPN.

Security

Your data is transferred directly between Macs. It is never stored on Warren's servers. The Group Code acts as a shared secret — only devices with the matching code can handshake and exchange data.

Troubleshooting