Normally MultiAgent is the control center: it holds the factory records, deploys agents and products onto the factories, and manages routing. But a factory can stand on your client’s machine rather than on yours — and then it makes sense to hand management over to the client: they get their own MultiAgent on their own server and run their own agents. Factory handover is a one-time operation that moves management of the records from your central instance to the client’s instance. The running applications themselves are not touched: they keep working, nothing stops and nothing gets reinstalled.
What this gives you in practice: the client becomes the full owner of their agents, applications and routes, while you stay responsible for the factory as a machine — SSH access, checks, folders, Docker cleanup — and for its own MultiAgent, whose container you can still recreate or update. During the handover, secrets travel directly between the two instances over a protected machine channel and never show up in the interface, the logs, or programmatic API responses.
How it works
MultiAgent itself is deployed onto the factory — as a regular product from the catalog, “New Agent” tab. Nothing separate to configure: the moment it appears, this instance receives the machine record and the factory record from central and connects to it right away. Records travel directly between the two MultiAgents, so the client types nothing by hand and no extra addresses need to be opened to the outside world.
While the factory runs its own MultiAgent, the factory page on the central instance grows a “Handover” action, and the page header gets a “Manage” button.
The Handover tab
The tab shows a preview: what exactly will move to the client and what stays with you. Changing your mind at this step costs nothing — the preview changes nothing.
- Moves: agents, product applications, tools, custom routes, certificate data, repository access keys, and optionally the licenses the agents reference — plus the machine record with its credentials: address, port, login, password or key and the jump host;
- Stays with you: the factory row itself — SSH access, checks, folders and Docker cleanup — and the MultiAgent application row, so you can keep recreating its container and updating its image.
The “Hand over” button starts the operation: it contacts the client’s instance once more, sends it all the records, and shows the transfer’s progress in a progress panel. The handover counts as successful only when every agent and tool record has landed on the client’s side. After that, the central instance forgets the transferred records — nothing is deleted on the machine itself, and the containers keep running as before.
If something goes wrong, nothing changes on your side: no marks, no deletions. The report names what blocked the operation — most often a name that is already taken on the client’s instance. Fix that on their side and run the handover again: a retry is safe. Failures in moving routes, certificates or repository keys do not block the handover — those records can be re-created manually on the client’s side if needed.
What happens after the handover
- The client controls routing. The factory’s web server is assembled from the client instance’s own records, so the client decides where the subfolders lead. Changing addresses and deploying new agents and products on the factory now go through their instance;
- Your side no longer rebuilds the configuration. Every operation that used to refresh the routes now simply notes in the log that the factory is handed over. This does not stop you from working with files over SSH, or from starting and stopping the applications you are still responsible for;
- The factory is handed over once. A second handover of the same factory is rejected with a clear message. Two systems editing one configuration at the same time are ruled out.
The header buttons: Manage and Login link
After the handover it is convenient to peek into the client’s instance: check how the agents settled in, sort out a taken name, look at their routes. The “Manage” button in the factory page header opens the client’s interface in a new tab, already logged in — no password to type, and none is stored anywhere.
For this, the central instance issues a one-time login link: the code is valid for five minutes and works exactly once. Someone else’s or an expired code simply lands on the client’s login page. The access key itself stays on your side and never reaches the browser. If the client’s instance sits behind a central login, you first pass that usual login once — the code is unaffected.
The same header row holds three more buttons for the factory’s central login: “Copy login” and “Copy password” put the credentials on the clipboard, and “Login link” issues a one-time QR-login link and copies it too. Every click on it creates a new link, and the ones issued earlier keep working. Details on the Factory Home Page page.
When something does not work
- The reply says the machine API is disabled (HTTP 503). The MultiAgent application was deployed before the access key — the one the instances use to talk to each other — existed. Recreate that application on the central instance and run the handover again;
- The reply says MultiAgent rejected the stored API key. That happens when the client’s instance was deployed from scratch and minted a new key. The fix is the same — recreate the application on the central instance;
- The transfer rejected some name. A record with that name already exists on the client’s instance. Rename or delete it there and run the handover again;
- The routes look stale. The client has not applied their configuration yet — it does not block the handover. Open their “Nginx” tab and press “Apply configuration”.
More on how factory routes work on the Nginx Routing page; on the MultiAgent application itself — on the Products page.