Get the one-line command that installs Tarsana on a server you have

Change · POST /v1/tenants/{tenant}/servers/{server_name}/install-command · MCP tool install-command

Returns a one-line command for the server you name. Run it once as root in the shell your provider gives you on that machine, such as its rescue system: it checks that what it downloads is signed by Tarsana, installs Tarsana's boot chain and connects the machine to your account as that server. The command holds a token that works once and expires at expires_at, and it is shown only once. Asking again for the same server_name replaces a command that has not been used yet. A server you create with create-server gets its command automatically

Roles that can call it: deployer.

Parameters

Returns

A JSON object with these keys: tenant, server_name, install_command, carrier, expires_at, superseded, guarantee, caller_authenticated.

Example request

curl -X POST https://api.tarsana.io/v1/tenants/acme/servers/web-1/install-command \
  -H "X-Tarsana-Access-Token: $ACCESS_TOKEN" \
  -H 'X-Tarsana-Tenant: acme'

Example response

{
  "tenant": "acme",
  "server_name": "web-1",
  "install_command": "A one-line shell command. Run it once, as root, on the server.",
  "carrier": "a root shell on the server -- your provider's rescue system or its stock OS -- once",
  "expires_at": "2026-10-05T03:15:39Z",
  "superseded": false,
  "guarantee": "namespaces are separated, callers are not authenticated",
  "caller_authenticated": false
}

Errors

View this page as Markdown