Dokploy CLI

Dokploy CLI is a command-line tool to manage your Dokploy server remotely. It provides 449 commands auto-generated from the Dokploy OpenAPI spec, covering every API endpoint.

Installation

npm install -g @dokploy/cli

Authentication

Option 1: Using the auth command

dokploy auth -u https://panel.dokploy.com -t YOUR_API_KEY

Option 2: Environment variables

export DOKPLOY_URL="https://panel.dokploy.com"
export DOKPLOY_API_KEY="YOUR_API_KEY"

Option 3: .env file

Create a .env file in your working directory:

DOKPLOY_URL="https://panel.dokploy.com"
DOKPLOY_API_KEY="YOUR_API_KEY"

The CLI loads it automatically. Shell environment variables take priority over the .env file.

Usage

dokploy <group> <action> [options]

Examples

# List all projects
dokploy project all
Get a specific project
dokploy project one --projectId abc123
Create an application
dokploy application create --name "my-app" --environmentId env123
Deploy an application
dokploy application deploy --applicationId app123
Create a postgres database
dokploy postgres create --name "my-db" --environmentId env123
Stop a database
dokploy postgres stop --postgresId pg123
Get raw JSON output
dokploy project all --json

Getting help

# List all groups
dokploy --help
List actions in a group
dokploy application --help
See options for a specific action
dokploy application deploy --help

Available command groups

Group	Commands	Group	Commands
admin	1	notification	38
ai	9	organization	10
application	29	patch	12
backup	11	port	4
bitbucket	7	postgres	14
certificates	4	preview-deployment	4
cluster	4	project	8
compose	28	redirects	4
deployment	8	redis	14
destination	6	registry	7
docker	7	rollback	2
domain	9	schedule	6
environment	7	security	4
gitea	8	server	16
github	6	settings	49
gitlab	7	ssh-key	6
git-provider	2	sso	10
license-key	6	stripe	7
mariadb	14	swarm	3
mongo	14	user	18
mounts	6	volume-backups	6
mysql	14

Development

# Install dependencies
pnpm install
Run in dev mode
pnpm run dev -- project all
Regenerate commands from OpenAPI spec
pnpm run generate
Build
pnpm run build
Lint & format
pnpm run lint

Updating commands

Commands are auto-generated from openapi.json. To update:

1. Replace openapi.json with the latest spec from the Dokploy repo
2. Run pnpm run generate
3. Build with pnpm run build

Contributing

If you want to contribute to Dokploy CLI, please check out our Contributing Guide.

Support

If you encounter any issues or have any questions, please open an issue in our GitHub repository.

License

This project is licensed under the MIT License.