Coolify icon

Coolify

Interact with Coolify to manage applications, services, databases, servers, deployments and more.

Server → Update

AI-generated

Summary

Update an existing server's configuration in Coolify by specifying its UUID along with new values for its details.

Inputs

  • serverUuid (required) — The UUID of the server to update, chosen from a list or provided as a raw ID.
  • name (required) — The new name for the server.
  • description — The new description of the server.
  • ip (required) — The new IP address of the server.
  • port — The new SSH port of the server (default 22).
  • user — The SSH user for the server (default 'root').
  • privateKeyUuid (required) — The UUID of the private key to use for SSH connection, selected from a list or provided as raw ID.
  • isBuildServer — Flag indicating whether the server is used for building applications.
  • instantValidate — Whether to validate the server immediately after update.
  • proxyType — The proxy type to use on the server: 'traefik', 'caddy', or 'none'.
  • concurrentBuilds — Number of concurrent builds allowed on this server.
  • dynamicTimeout — Deployment timeout in seconds.
  • deploymentQueueLimit — Maximum number of queued deployments.
  • serverDiskUsageNotificationThreshold — Disk usage notification threshold percentage.
  • serverDiskUsageCheckFrequency — Cron expression defining the frequency of disk usage checks.

Output shape

a single updated server record as returned by the Coolify API

The output includes updated server details as returned by the PATCH /api/v1/servers/{serverUuid} endpoint. Errors will be raised if the server UUID is invalid or required fields are missing.

Links

Discussion