Command lineCommands

Backups of an agent

The backups of the memory of an agent, and a new agent restored from one. The panel does the same on the Backups tab of an agent.

Who can do it

Any member of the project.

Every night the node backs up the memory of the Kikimora of the agent and sends the backup to the platform. A backup needs Kikimora 0.12.0 or newer.

Step 1: Make a backup now

The command asks the node for a backup besides the nightly one and returns before the node has made it. The backup appears in the list once the node has sent it. The node of the agent has to be connected.

$ kcloud agents backups create sandbox/release-notes

Output

Backup of sandbox/release-notes requested. kcloud agents backups list sandbox/release-notes shows it once the node has sent it.

Step 2: List the backups

The newest backups come first, with who made each (the night or a person), its node, its Kikimora release, its entries, its size and when it expires.

$ kcloud agents backups list sandbox/release-notes

Output

CREATED                   TRIGGER  NODE     KIKIMORA  ENTRIES      SIZE  EXPIRES                   ID
2026-03-14T09:30:00.000Z  manual   acme-01  0.12.0         14  42.0 KiB  2026-03-14T09:30:00.000Z  0195a3c4-7e21-7b6d-9f40-3c81a4d2e600
2026-03-14T09:30:00.000Z  nightly  acme-01  0.12.0         12  39.0 KiB  2026-03-14T09:30:00.000Z  0195a3c4-7e21-7b6d-9f40-3c81a4d2e601
A backup is kept for 30 days.

Step 3: Restore an agent from a backup

The command creates a new agent in the project of the source, with its settings and with the memory and tasks of the backup. --backup is the id from the list of backups, --name the name of the new agent and --node the node it runs on. The new agent waits, stopped, for kcloud agents start.

$ kcloud agents restore sandbox/release-notes --backup 0195a3c4-7e21-7b6d-9f40-3c81a4d2e600 --name "Release notes copy" --node acme-01

Output

Restored Release notes copy as 0195a3c4-7e21-7b6d-9f40-3c81a4d2e600 from backup 0195a3c4-7e21-7b6d-9f40-3c81a4d2e601 of sandbox/release-notes.
kcloud agents start 0195a3c4-7e21-7b6d-9f40-3c81a4d2e600 starts it once it is provisioned.

Tasks of an agent What an agent does

Matches the panel at cloud.kikimora.dev.