Applications

Applications are the primary workload unit in Dokploy. They can be sourced from GitHub, GitLab, Bitbucket, Gitea, a custom Git URL, a Docker image, or a file drop. Once created, you can configure the build type, environment variables, domains, and then trigger a deployment — all programmatically through the API.

Endpoints

Method	Endpoint	Description
POST	`/application.create`	Create a new application
GET	`/application.one`	Fetch a single application by ID
POST	`/application.update`	Update application configuration
POST	`/application.delete`	Delete an application
POST	`/application.deploy`	Trigger a new deployment
POST	`/application.redeploy`	Re-run the last deployment
POST	`/application.stop`	Stop the running application
POST	`/application.start`	Start a stopped application
POST	`/application.reload`	Reload the application service
POST	`/application.saveEnvironment`	Save environment variables and build args
POST	`/application.saveBuildType`	Configure build type (Dockerfile, Nixpacks, etc.)
POST	`/application.saveGithubProvider`	Link a GitHub repository
POST	`/application.saveGitlabProvider`	Link a GitLab repository
POST	`/application.saveBitbucketProvider`	Link a Bitbucket repository
POST	`/application.saveGiteaProvider`	Link a Gitea repository
POST	`/application.saveDockerProvider`	Set a Docker image as the source
POST	`/application.saveGitProvider`	Link a custom Git repository
POST	`/application.disconnectGitProvider`	Remove the linked Git provider
POST	`/application.refreshToken`	Regenerate the webhook token
POST	`/application.cleanQueues`	Clear the deployment job queue
POST	`/application.clearDeployments`	Remove old deployment records
POST	`/application.killBuild`	Abort an in-progress build
GET	`/application.readTraefikConfig`	Read the Traefik routing config
POST	`/application.updateTraefikConfig`	Update the Traefik routing config
GET	`/application.readAppMonitoring`	Get resource monitoring stats
POST	`/application.move`	Move an application to another environment
POST	`/application.cancelDeployment`	Cancel a queued or running deployment
POST	`/application.markRunning`	Manually mark an application as running
GET	`/application.search`	Search applications

Key Endpoints

`POST /application.create`

Create a new application within a project environment.

name

string

required

Display name for the application.

environmentId

string

required

ID of the environment (inside a project) to create the application in.

appName

string

Internal Docker service name. Auto-generated if omitted.

description

string

Optional description of the application.

serverId

string

Target server ID. Required in cloud mode or when remoteServersOnly is enabled.

applicationId

string

Unique identifier of the created application.

appName

string

The internal Docker service name assigned to the application.

name

string

Display name of the application.

applicationStatus

string

Initial status — idle, running, done, or error.

curl -X POST 'https://your-instance.com/api/application.create' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-web-app",
    "environmentId": "env_abc123"
  }'

`POST /application.deploy`

Trigger a full build and deployment of the application from its configured source.

applicationId

string

required

ID of the application to deploy.

title

string

Optional label shown in the deployment history.

description

string

Optional notes about this deployment.

curl -X POST 'https://your-instance.com/api/application.deploy' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicationId": "app_xyz789",
    "title": "Release v1.2.0",
    "description": "New feature: dark mode"
  }'

`POST /application.redeploy`

Re-run the most recent deployment without pulling new source code.

applicationId

string

required

ID of the application to redeploy.

title

string

Optional label for this redeployment entry.

description

string

Optional notes.

curl -X POST 'https://your-instance.com/api/application.redeploy' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicationId": "app_xyz789"
  }'

`POST /application.saveEnvironment`

Set or update environment variables, build arguments, and build secrets for an application.

applicationId

string

required

ID of the application.

env

string | null

required

Newline-separated KEY=VALUE pairs for runtime environment variables. Pass null to clear.

buildArgs

string | null

required

Newline-separated Docker build arguments (ARG_NAME=value). Pass null to clear.

buildSecrets

string | null

required

Newline-separated build secrets. Pass null to clear.

createEnvFile

boolean

required

When true, write a .env file into the container at runtime.

curl -X POST 'https://your-instance.com/api/application.saveEnvironment' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicationId": "app_xyz789",
    "env": "DATABASE_URL=postgres://localhost/mydb\nPORT=3000",
    "buildArgs": null,
    "buildSecrets": null,
    "createEnvFile": false
  }'

`POST /application.update`

Update any property of an existing application — name, resource limits, source provider fields, Swarm config, and more.

applicationId

string

required

ID of the application to update.

name

string

New display name.

replicas

number

Desired number of running replicas.

memoryLimit

string

Hard memory limit (e.g., 512m, 1g).

cpuLimit

string

Hard CPU limit (e.g., 0.5, 1).

autoDeploy

boolean

Enable automatic deployment on Git push webhook.

buildType

string

Build strategy: dockerfile, heroku_buildpacks, paketo_buildpacks, nixpacks, static, or railpack.

curl -X POST 'https://your-instance.com/api/application.update' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicationId": "app_xyz789",
    "replicas": 2,
    "memoryLimit": "512m",
    "autoDeploy": true
  }'

`POST /application.delete`

Permanently delete an application and remove its Docker service and Traefik configuration.

applicationId

string

required

ID of the application to delete.

This action is irreversible. The application’s Docker service, configs, and deployment history are permanently removed.

curl -X POST 'https://your-instance.com/api/application.delete' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicationId": "app_xyz789"
  }'

Notes

To automate CI/CD, call application.deploy from your pipeline after pushing code. Combine with application.saveEnvironment to inject build-time secrets securely.

All endpoints require a valid API key passed in the x-api-key header. Generate one under Settings → API Keys in the Dokploy dashboard.

Overview

Applications & Compose

Databases

Infrastructure

Configuration

Endpoints

Key Endpoints

`POST /application.create`

`POST /application.deploy`

`POST /application.redeploy`

`POST /application.saveEnvironment`

`POST /application.update`

`POST /application.delete`

Notes

Build docs developers (and LLMs) love

Overview

Applications & Compose

Databases

Infrastructure

Configuration

Documentation Index

​Endpoints

​Key Endpoints

​POST /application.create

​POST /application.deploy

​POST /application.redeploy

​POST /application.saveEnvironment

​POST /application.update

​POST /application.delete

​Notes

Build docs developers (and LLMs) love

Endpoints

Key Endpoints

`POST /application.create`

`POST /application.deploy`

`POST /application.redeploy`

`POST /application.saveEnvironment`

`POST /application.update`

`POST /application.delete`

Notes