remoteagent.online  the open-source control plane for secure, cost-controlled AI agents

Back up and restore your agent configuration

Back up your agent config, keys, and history, and restore them on a new machine. What to copy and what to leave behind.

Updated 2026-08-22Reading time 4 min

What to back up

  • Agent definitions and settings (name, model, capabilities).
  • The audit history (export as JSONL).
  • The device policy file, if you customised it.
  • Anything in the agent workspace you want to keep.

What not to back up

Provider keys — they live in the vault, not on the device. A backup of the device should never contain a real key, which is the whole point of the design.

Back up the history

  1. Open History → Export.
  2. Download the JSONL file.
  3. Store it with your other backups.

Restore on a new machine

  1. Install the agent on the new machine.
  2. Run remoteagent login and approve it.
  3. Reassign agents to the new device.
  4. Re-import anything from the old workspace you still need.

Migration tip

i
Keys never need migrating — they stay in the vault. Move the device, re-link, and the same keys work immediately.