How to Set Up Multi-Device¶
Step-by-step guide for using Vauchi on multiple devices.
Prerequisites¶
- Your existing device with Vauchi set up
- A new device with Vauchi installed (but not set up)
- Both devices have internet connectivity
Linking a New Device¶
Step 1: Generate Link Code¶
On your existing device:
- Open Vauchi
- Go to Settings (gear icon)
- Tap Devices
- Tap Link New Device
- A QR code appears (valid for 10 minutes)
Step 2: Join on New Device¶
On your new device:
- Open Vauchi
- On the welcome screen, tap Join Existing Identity
- Point your camera at the QR code from Step 1
- Wait for the linking to complete
Step 3: Confirm¶
Both devices should show:
- Your existing device: "Device linked successfully"
- Your new device: "Welcome back, [Your Name]"
Your new device is now synced with your identity.
Verifying Setup¶
After linking:
On New Device¶
- Go to Contacts — your contacts should appear
- Go to Home — your contact card should appear
- Go to Settings > Devices — both devices should be listed
On Existing Device¶
- Go to Settings > Devices
- You should see both devices listed
- Your new device shows its platform and last sync time
Syncing Data¶
Data syncs automatically:
- Immediately: When both devices are online
- On app open: When you open the app
- Manual: Pull to refresh or Settings > Sync Now
What Syncs¶
| Data | Syncs? |
|---|---|
| Your contact card | Yes |
| Your contacts | Yes |
| Visibility settings | Yes |
| App preferences | Yes |
Managing Devices¶
Viewing All Devices¶
- Go to Settings > Devices
- See all linked devices
- Your current device is marked
Renaming a Device¶
- Go to Settings > Devices
- Tap on a device
- Tap Rename
- Enter a new name (e.g., "Work Laptop", "iPad")
Revoking a Device¶
If a device is lost, stolen, or no longer needed:
- Go to Settings > Devices on another device
- Find the device to revoke
- Tap Revoke
- Confirm by tapping Revoke Device
Warning
You cannot revoke your current device. Use another linked device.
Danger
Revocation is immediate and permanent. The revoked device loses all access.
Troubleshooting¶
Link Code Expired¶
QR codes are valid for 10 minutes. If expired:
- On your existing device, go back to Settings > Devices
- Tap Link New Device again
- A fresh QR code appears
- Scan it quickly
New Device Not Syncing¶
- Check internet on both devices
- Wait a few minutes for initial sync
- Pull to refresh on the new device
- Check Settings > Sync for last sync time
Device Not Appearing in List¶
- On both devices, go to Settings > Devices
- Pull to refresh
- Wait 1-2 minutes
- If still missing, try unlinking and relinking
"Too Many Devices" Error¶
You can have up to 5 devices. To add another:
- Go to Settings > Devices
- Revoke a device you no longer use
- Try linking the new device again
Migrating to a New Phone¶
Option 1: Device Linking (Recommended)¶
- Keep your old phone accessible
- Follow the steps above to link your new phone
- Wait for sync to complete
- Optionally, revoke your old phone
This is the cleanest migration path.
Option 2: Backup & Restore¶
If you can't access your old phone:
- Restore from an encrypted backup
- See How to Recover Your Account
Security Notes¶
- Each device has its own derived keys
- Revoking a device invalidates its keys immediately
- The relay never sees plaintext data
- Link codes expire after 10 minutes
For more on security, see Multi-Device Feature.