InfraCanvas Docs

Connect a VM to multiple accounts

One machine can stream to several InfraCanvas accounts at once — without disconnecting any of them.

A single machine can belong to more than one account at the same time — useful when a server is shared across teams, or between a personal and an org account.

Requires agent 1.4.0 or newer. Older agents were single-account: adding a second account would replace the first. Update the agent from its machine card, then add the new account.

How it works

The agent runs as one process but opens one connection per account. It scans the host once and fans the same topology out to every connected account — so there's no extra load from adding accounts. If one account's connection drops, the others keep streaming.

Add another account

On the machine that's already connected, re-run the connect command using the new account's API key:

curl -fsSL https://cloud.infracanvas.app/api/v1/install | \
  INFRACANVAS_API_KEY=ic_NEW_ACCOUNT_KEY INFRACANVAS_API_URL=https://cloud.infracanvas.app bash

The installer appends the new token to /etc/infracanvas/tokens (one token per line) and keeps every existing account connected. The machine now appears online in both accounts.

Identity

Each account gets a stable identity for the machine, derived from the API key and the machine's real hostname — so the same box reconnecting always maps to the same node, and two different machines sharing a key never collide.

Use one API key per machine as a rule (name the key after the machine). Reusing a single key across many machines still works, but per-machine keys keep identities and audit logs clean.

On this page