Coolify logoCoolify
Cloud

Log in to a registry on a server

API server

https://app.coolify.io/api/v1

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

https://app.coolify.io/api/v1

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

POST
/servers/{uuid}/registries

Run docker login on the server, writing to the Docker config that deployments use. Logging in again to the same registry replaces the saved login.

Authorization

bearerAuth
AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Path Parameters

uuid*string

Server UUID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

registry*string

Registry host, optionally with a port. Use docker.io for Docker Hub.

username*string
password*string

Password or access token. Never returned.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.coolify.io/api/v1/servers/string/registries" \  -H "Content-Type: application/json" \  -d '{    "registry": "ghcr.io",    "username": "octocat",    "password": "string"  }'
{  "message": "Logged in to ghcr.io."}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}

List GET

List all servers.

Log out from a registry on a server DELETE

Run docker logout on the server for a registry.