Skip to main content

Overview

The Docker Containers API allows you to manage and monitor Docker containers across your Dokploy servers. You can list containers, restart them, inspect configurations, and filter by application labels.

Get Containers

string
The ID of the server to get containers from. If not provided, returns containers from the default server.

Response

Returns an array of container objects with details about each running container.
cURL

Restart Container

Restart a specific Docker container by its ID.
string
required
The ID of the container to restart. Must match the pattern ^[a-zA-Z0-9.\-_]+$.
cURL

Get Container Configuration

Retrieve detailed configuration information for a specific container.
string
required
The ID of the container to inspect.
string
The server ID where the container is running.

Response

Returns the full Docker container configuration including environment variables, volumes, networks, and resource limits.
cURL

Get Containers by Application Name

Find containers that match a specific application name pattern.
string
required
The application name to search for. Must match pattern ^[a-zA-Z0-9.\-_]+$.
string
The type of application. Can be either stack or docker-compose.
string
The server ID to search within.
cURL

Get Containers by Label

Retrieve containers filtered by application label.
string
required
The application name label to filter by.
string
required
The deployment type: standalone or swarm.
string
The server ID to query.
cURL

Get Stack Containers

Get all containers for a Docker Stack application.
string
required
The stack application name.
string
The server ID hosting the stack.
cURL

Get Service Containers

Retrieve containers for a Docker Swarm service.
string
required
The service application name.
string
The server ID running the service.
cURL