Agent job kinds
Every job the panel can send to a node. The agent leases jobs one at a time per server; see the agent protocol. Unknown kinds are failed with an error.
| Kind | What it does |
|---|---|
agent.update | Download the new agent, verify its SHA-256, trial-run it, keep the old binary as .prev, swap and re-execute. |
backup | Archive the server's data (from a frozen snapshot when the node uses volumes) and upload it with the signed URL. |
command | Send one console command: RCON for Minecraft (queued on the console pipe while the server is starting), stdin for other games. |
configure | Apply new limits to a running container, or (with recreate) remove and recreate it with new settings, ports or environment. Also resizes the data volume. |
create | Create the data volume and the container for a server and start it. |
delete | Remove the container, its data volume and its files. |
evict | Remove this node's copy of a server that now lives elsewhere (failover); data is moved aside and kept for the configured retention. |
file.delete | Delete regular files (never folders, never through symlinks). |
file.download | Stream a file for download. |
file.export | Send a file or folder from the server's data directory to the panel for download. |
file.extract | Extract an archive inside the data directory with traversal protection. |
file.fetch | Download one file for an add-on: HTTPS only, hosts listed in the job, public addresses only, SHA-512 (or SHA-256) must match, size counted against the disk allowance, placed atomically. An optional replace list removes old files only after the new one is in place. |
file.import | Receive an uploaded file from the panel into the server's data directory. |
file.list | List a folder in the server's data directory. |
file.mkdir | Create a folder. |
file.read | Read a text file for the editor. |
file.rename | Rename a file; used for add-ons only to add or drop the .disabled suffix, never overwriting. |
file.upload | Write an uploaded file. |
file.write | Write a text file from the editor. |
kill | Kill the container immediately. |
logs | Return the last lines of the container log. |
reinstall | Delete the server's data and container and create them again. |
restart | Stop gracefully and start again. |
restore | Download a backup and replace the server's files with it, staging before the swap. Can restore a backup of another server (clone, failover). |
start | Start the container (re-mounting the data volume first when needed). |
stop | Stop gracefully: RCON or the console pipe for Minecraft, otherwise docker stop. |
verify-backup | Download a backup archive and check its integrity and safe extraction. |
