dokploy_application
Manage Dokploy applications: create, deploy, update, and control lifecycle with environment variables, build options, and monitoring.
Instructions
Manage applications. create: name+environmentId. get: applicationId (returns metadata + masked env summary — never values). update: applicationId+fields (supports sourceType, repository, owner, branch, customGitUrl, customGitBranch, githubId, dockerImage, etc.). move: applicationId+targetEnvironmentId. deploy: applicationId, redeploy? (note: first deploy on new services may fail — retry immediately). start/stop/delete/markRunning/refreshToken/cleanQueues/killBuild/cancelDeployment: applicationId. reload: applicationId+appName. saveEnvironment: applicationId+env (KEY=VALUE pairs, full replace). setEnvVars: applicationId + set? (KEY=VALUE pairs to upsert) + unset? (KEY names to remove) — read-modify-write inside the server; result is a masked confirmation with changed key names only. getEnvKeys: applicationId — returns just the KEY names (no values). getEnvValuesUnsafe: applicationId — UNSAFE escape hatch that returns full KEY=VALUE pairs (use only when you need actual values; output goes to the tool transcript and any retained logs). saveBuildType: applicationId+buildType. traefikConfig: applicationId, traefikConfig? (omit to read). readMonitoring: appName. readLogs: applicationId, tail? (default 100), since? ('all' or duration like '1h'), search? (substring filter).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | Environment variables as KEY=VALUE pairs, one per line. Example: 'DB_HOST=localhost\nDB_PORT=5432'. Used by saveEnvironment (full replace). | |
| set | No | setEnvVars: KEY=VALUE pairs to upsert, one per line. Existing keys retain order; new keys append. | |
| name | No | ||
| tail | No | Number of recent log lines to return (default 100) | |
| owner | No | GitHub org/user | |
| since | No | Time range: 'all' or a duration like '30m', '1h', '7d' | |
| title | No | ||
| unset | No | setEnvVars: list of KEY names to remove. Unknown keys are silently skipped. | |
| action | Yes | ||
| branch | No | Branch name | |
| search | No | Filter log lines by substring (alphanumeric + ' ._-' only) | |
| appName | No | ||
| command | No | ||
| cpuLimit | No | ||
| githubId | No | GitHub App provider ID for private repo access | |
| redeploy | No | ||
| replicas | No | ||
| serverId | No | ||
| buildArgs | No | ||
| buildType | No | dockerfile | heroku_buildpacks | paketo_buildpacks | nixpacks | static | railpack | |
| autoDeploy | No | ||
| dockerfile | No | ||
| repository | No | GitHub repository name | |
| sourceType | No | Source type. github → set repository+owner+branch (+githubId for private). git → set customGitUrl+customGitBranch. docker → set dockerImage. The API also supports gitlab/bitbucket/gitea/drop sources, but those need provider-specific fields not yet exposed by this tool. | |
| description | No | ||
| dockerImage | No | ||
| memoryLimit | No | ||
| buildSecrets | No | ||
| customGitUrl | No | Custom git repository URL (for sourceType: git) | |
| applicationId | No | ||
| createEnvFile | No | ||
| environmentId | No | ||
| traefikConfig | No | New config content (omit to read current) | |
| customGitBranch | No | Branch for custom git source | |
| dockerBuildStage | No | ||
| publishDirectory | No | ||
| deployDescription | No | Deploy description (maps to API description field) | |
| dockerContextPath | No | ||
| targetEnvironmentId | No |