@dollardeploy/cli

Deploy apps to your own servers from the command line. Zero DevOps, full control.

The DollarDeploy CLI (ddc) lets you manage servers, deploy applications, and control your infrastructure — all from the terminal. Designed for CI/CD pipelines, AI agents, and developers who prefer the command line.

Installation

npm install -g @dollardeploy/cli

Or use npx:

npx @dollardeploy/cli help

Quick Start

1. Get an API Key

Sign in at dollardeploy.com
Go to Settings → API Keys
Click Create API Key and copy it

2. Authenticate

# Interactive
ddc auth

# Non-interactive
ddc auth --api-key <your-api-key>

Your API key is saved to ~/.dollardeploy/auth and can be overridden with the --api-key flag or DOLLARDEPLOY_API_KEY environment variable.

3. Deploy

# Deploy from GitHub to an existing host
ddc deploy --url https://github.com/your-org/your-app --hostId <host-id>

# Deploy and auto-create a host
ddc deploy --url https://github.com/your-org/your-app --create-host

# Deploy from a template
ddc deploy --template nextjs-boilerplate --hostId <host-id>

Host Lifecycle

A host goes through a few stages: create → provision → prepare → (deploy apps) → deprovision / destroy.

ddc host create --provider ... runs all of the setup steps for you in one call. The individual commands exist for when you want to run a stage on its own — for example, provisioning a server for a host you created earlier, or re-preparing a host without touching the VM.

# 1. Create the host record and provision a server in one step
ddc host create --name my-server --provider hetzner
#    ↳ creates the host, provisions the VM, tests SSH, installs services, prepares it

# --- or run the stages yourself ---

# 1a. Create just the host record (no server yet)
ddc host create --name my-server
#    → prints the new host id, status: draft

# 1b. Provision a server for that host
ddc host provision <host-id> --provider hetzner
#    → status: active, IP assigned

# 1c. Verify SSH connectivity
ddc host test <host-id>

# 1d. Prepare the host for deployments (installs Docker, configures the box)
ddc host prepare <host-id>

# 2. Deploy apps to it
ddc deploy --url https://github.com/org/repo --hostId <host-id>

# 3. When you're done, tear it down
ddc host destroy <host-id>          # deprovision the VM AND delete the host record
# or, to keep the host record but delete the server:
ddc host deprovision <host-id>
# or, to stop managing it without deleting the server:
ddc host remove <host-id>

Tip: run ddc host list at any point to see each host's status and ip. Long-running stages (provision, prepare, deploy) print progress; add --json for machine-readable output.

Commands

`ddc auth`

Save your API key for future commands.

ddc auth                        # Interactive prompt
ddc auth --api-key <key>        # Non-interactive

API key resolution order: --api-key flag > DOLLARDEPLOY_API_KEY env var > ~/.dollardeploy/auth file.

`ddc user`

Show current user information.

ddc user

`ddc host list`

List all hosts in your account.

ddc host list
ddc host list --status active
ddc host list --json              # Machine-readable output

`ddc host create`

Create and provision a new host. You need to set the integration with your cloud provider first in the DollarDeploy Settings => Integrations.

# Just create a host entry
ddc host create --name my-server

# Create a host on Hetzner
ddc host create --name my-server --provider hetzner --type cpx31 --region fsn1

# Create a host on DigitalOcean
ddc host create --name my-server --provider do --type s-2vcpu-4gb --region fra1

# Create a host on Verda Cloud (formerly DataCrunch)
ddc host create --name my-server --provider verda --type CPU.4V.16G --region FIN-01

# Create a host with Docker and PostgreSQL
ddc host create --name my-server --services docker,postgres

Option	Description	Default
`--name`	Host name	auto-generated
`--provider`	Cloud provider: `hetzner`, `do`, `datacrunch`	`hetzner`
`--type`	Instance type	`cax11`
`--region`	Provider region	`fsn1`
`--image`	OS image	`ubuntu-24.04`
`--services`	Comma-separated services to install	`docker`
`--skip-prepare`	Skip host preparation step	`false`
`--timeout`	Timeout in milliseconds	`600000`

`ddc host provision <id>`

Provision (or reprovision) a server for an existing host. Pass provider flags to save the provider config before provisioning; omit them to provision using the config already saved on the host.

# Provision using flags
ddc host provision <host-id> --provider hetzner --type cax11 --region fsn1

# Provision using the host's already-saved provider config
ddc host provision <host-id>

Option	Description	Default
`--provider`	Save this provider before provisioning	—
`--type`	Instance type (uses provider default if omitted)	provider based
`--region`	Provider region (uses provider default if omitted)	provider based
`--image`	OS image (uses provider default if omitted)	provider based
`--timeout`	Timeout in milliseconds	`600000`

Not sure which --type, --region, or --image values are valid? Run ddc provision --provider <p> to list everything the provider supports.

`ddc host test <id>`

Test the SSH connection to a host.

ddc host test <host-id>

`ddc host prepare <id>`

Prepare a host for deployment. This will install the necessary services and configure the host for deployment.

ddc host prepare <host-id>

`ddc host service`

Manage the services (Docker, PostgreSQL, etc.) installed on a host.

# List installed services
ddc host service list <host-id>

# Install a service
ddc host service add <host-id> docker

# Remove a service
ddc host service remove <host-id> <service-id>

`ddc host deprovision <id>`

Deprovision the server (removes the VM from your cloud provider) but keep the host record in DollarDeploy, so you can provision it again later.

ddc host deprovision <host-id>
ddc host deprovision <host-id> --yes    # Skip confirmation

`ddc host destroy <id>`

Deprovision and permanently delete a host. This removes the VM from your cloud provider and deletes the host record along with all apps on it.

ddc host destroy <host-id>
ddc host destroy <host-id> --yes    # DANGEROUS: Skip confirmation

`ddc host remove <id>`

Remove a host from DollarDeploy without deprovisioning. The server continues running but is no longer managed.

ddc host remove <host-id>
ddc host remove <host-id> --yes     # DANGEROUS: Skip confirmation

`ddc provision`

List the regions, instance types, and images a provider supports, queried live from the provider API. Use it to discover valid --type, --region, and --image values before running ddc host create or ddc host provision.

The provider must be connected first (Settings → Integrations in the dashboard). --provider is required; all other flags narrow down the instance type list.

# List everything available for a provider
ddc provision --provider hetzner

# Only show types available in a region
ddc provision --provider hetzner --region fsn1

# Only show ARM types with at least 4 vCPUs and 8 GB memory
ddc provision --provider hetzner --arch arm64 --cpu 4 --memory 8192

# Full config as JSON (regions, types, images, defaults)
ddc provision --provider do --json

Example output:

Provider: hetzner  default region: fsn1  default image: ubuntu-24.04  default arch: arm64

Regions:
id    label
----  ------------
fsn1  Falkenstein
nbg1  Nuremberg
hel1  Helsinki
...

Instance types:
type   cpu  memoryGB  diskGB  arch   gpu  regions
-----  ---  --------  ------  -----  ---  -------
cax11  2    4         40      arm64       all
cax21  4    8         80      arm64       all
...

Images:
image
------------
ubuntu-24.04
debian-12
...

Option	Description	Default
`--provider`	Required. Cloud provider: `hetzner`, `do`, `datacrunch`	—
`--region`	Filter instance types available in a region	—
`--type`	Show details for a specific instance type	—
`--arch`	Filter by architecture (e.g. `arm64`, `amd64`)	—
`--cpu`	Filter to types with at least N vCPUs	—
`--memory`	Filter to types with at least N MB of memory	—
`--disk`	Filter to types with at least N GB of disk	—

`ddc deploy`

Deploy an application to a host. Supports GitHub repos, templates, and redeployment of existing apps.

Also available as ddc app deploy.

# Deploy from GitHub (will redeploy existing app if URL matches)
ddc deploy --url https://github.com/org/repo --hostId <host-id>

# Deploy with a new host
ddc deploy --url https://github.com/org/repo --create-host

# Deploy a template
ddc deploy --template twenty-crm --hostId <host-id>

# Redeploy an existing app
ddc deploy --appId <app-id>

# Deploy with environment variables
ddc deploy --url https://github.com/org/repo --hostId <host-id> --env:DATABASE_URL postgres://...

# Deploy with app property overrides
ddc deploy --url https://github.com/org/repo --hostId <host-id> --set:mainPort 8080

The deploy command is smart about redeployment — if you deploy the same GitHub URL to the same host, it will detect the existing app and redeploy it instead of creating a duplicate.

Option	Description
`--url`	GitHub repository URL
`--template`	Template ID to deploy
`--appId`	Existing app ID to redeploy
`--hostId`	Target host ID
`--create-host`	Create a new host for deployment
`--name`	App name
`--env NAME=VALUE`	Set environment variable
`--set:<key>`	Set app property (mainPort, env:PROPERTY_NAME, etc.)
`--provider`	Provider for `--create-host`
`--type`	Instance type for `--create-host`
`--region`	Region for `--create-host`
`--services`	Services for `--create-host`
`--timeout`	Timeout in milliseconds (default: 600000)

`ddc build`

Build an app, optionally deploying it after build.

Also available as ddc app build.

ddc build <app-id>
ddc build <app-id> --deploy

Option	Description
`--deploy`	Deploy after building
`--timeout`	Timeout in milliseconds (default: 600000)

`ddc app list`

List all apps in your account.

ddc app list
ddc app list --json

`ddc app remove <id>`

Undeploy an app from its host. By default the app is also deleted; use --keep to undeploy but keep the app configuration for later.

ddc app remove <app-id>             # Undeploy and delete the app
ddc app remove <app-id> --keep      # Undeploy but keep the configuration
ddc app remove <app-id> --yes       # Skip confirmation

Option	Description
`--keep`	Keep the app configuration (undeploy only)
`--yes`, `--force`	Skip confirmation prompt
`--timeout`	Timeout in milliseconds (default: 600000)

`ddc template list`

List all templates.

ddc template list
ddc template list <search>
ddc template list --json

`ddc ssh add`

Add an SSH public key to your DollarDeploy account.

ddc ssh add ${HOME}/.ssh/id_rsa --name my-key

Option	Description
`--name`	Key name (default: cli-added-key)

`ddc ssh list`

List all SSH keys in your account.

ddc ssh list
ddc ssh list --name my-key

`ddc ssh remove <id>`

Delete an SSH key from your account.

ddc ssh remove <key-id>
ddc ssh remove <key-id> --yes       # Skip confirmation

`ddc task`

Inspect and control the background tasks that run provisioning, builds, and deployments.

ddc task list                       # List recent tasks
ddc task list --status running      # Filter by status
ddc task get <task-id>              # Show a single task
ddc task cancel <task-id>           # Cancel a running task

`ddc logs`

Show journal logs. Filter by task, app, or host, and optionally follow for new entries.

ddc logs --task <task-id>
ddc logs --app <app-id>
ddc logs --host <host-id>
ddc logs --app <app-id> --follow    # Stream new log entries

Option	Description	Default
`--task`	Filter logs by task ID	—
`--app`	Filter logs by app ID	—
`--host`	Filter logs by host ID	—
`--type`	Log types (comma separated: `info,warn,error,health,log,ai`)	`info,warn,error`
`--limit`	Number of records	`50`
`--follow`, `-f`	Continuously poll for new logs	`false`

Global Options

Option	Description
`--api-key <key>`	API key (overrides stored auth and env var)
`--base-url <url>`	API base URL (default: `https://dollardeploy.com`)
`--json`	Output as JSON (machine-readable)
`--verbose`, `-v`	Enable verbose logging
`--help`, `-h`	Show help
`--version`, `-V`	Show version

JSON Output (AI Agent Friendly)

All commands support --json for structured, machine-readable output:

ddc host list --json
ddc deploy --url https://github.com/org/repo --hostId <id> --json

JSON output goes to stdout, while progress/status messages go to stderr, making it easy to pipe results into other tools.

Environment Variables

Variable	Description	Default
`DOLLARDEPLOY_API_KEY`	Your API key	—
`DOLLARDEPLOY_BASE_URL`	API base URL	`https://dollardeploy.com`

Provider Defaults

Provider	Type	Region	Image
Hetzner	`cax11`	`fsn1`	`ubuntu-24.04`
DigitalOcean	`s-2vcpu-4gb`	`fra1`	`ubuntu-24-04`
Verda Cloud	`CPU.4V.16G`	`FIN-01`	`ubuntu-24.04`

CI/CD Integration

GitHub Actions

name: Deploy my app

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "22"

      - name: Deploy
        env:
          DOLLARDEPLOY_API_KEY: ${{ secrets.DOLLARDEPLOY_API_KEY }}
        run: |
          npm install -g @dollardeploy/cli
          ddc deploy --url ${{ github.server_url }}/${{ github.repository }}

Programmatic Usage

Use the CLI as a Node.js library:

const { createApiClient, waitForTask, checkUrl } = require("@dollardeploy/cli");

const api = createApiClient({
  apiKey: process.env.DOLLARDEPLOY_API_KEY,
  baseUrl: "https://dollardeploy.com"
});

// List all hosts
const hosts = await api.listHosts();

// Create and provision a host
const host = await api.createHost("my-server");
await api.saveProvision(host.id, {
  provider: "hetzner",
  providerType: "cax11",
  providerRegion: "fsn1",
  image: "ubuntu-24.04"
});
const task = await api.startProvision(host.id);
await waitForTask(api, task.id);

// Deploy an app
const app = await api.createApp({
  repositoryUrl: "https://github.com/org/repo",
  hostId: host.id,
  name: "my-app"
});
const buildTask = await api.buildApp(app.id, { deploy: true });
await waitForTask(api, buildTask.id);

// Verify deployment
await checkUrl(`https://${app.hostname}`);

API Client Methods

Hosts

Method	Description
`createHost(name?)`	Create a new host
`getHost(id)`	Get host details
`listHosts(status?)`	List all hosts
`updateHost(id, data)`	Update host configuration
`deleteHost(id)`	Delete a host
`testConnection(hostId)`	Test SSH connection
`prepareHost(hostId)`	Prepare host for deployments

Provisioning

Method	Description
`getProvision(hostId)`	Get provision config
`saveProvision(hostId, data)`	Save provision config
`provisionHost(hostId)`	Start provisioning
`startProvision(hostId)`	Alias for provisionHost
`getProviderConfig(provider, filters?)`	List a provider's regions, instance types, and images
`deprovisionHost(hostId, deleteHost?)`	Deprovision (deletes the host record when `deleteHost` is `true`, the default)

Services

Method	Description
`listServices(hostId)`	List installed services
`createService(hostId, type)`	Install a service
`deleteService(hostId, serviceId)`	Remove a service

Apps

Method	Description
`createApp(config)`	Create a new app
`getApp(id)`	Get app details
`listApps()`	List all apps
`updateApp(id, data)`	Update app configuration
`suggestApp(app)`	Get AI configuration suggestions
`buildApp(id, options?)`	Build app (optionally deploy)
`deployApp(id)`	Deploy built app
`deleteApp(id)`	Delete an app
`removeApp(id, options?)`	Remove app from host

SSH Keys

Method	Description
`listSshKeys()`	List all SSH keys
`createSshKey(data)`	Create an SSH key
`deleteSshKey(id)`	Delete an SSH key

Templates

Method	Description
`getTemplates()`	List all templates
`getTemplate(id)`	Get template details
`launchTemplate(config)`	Launch from template

Tasks

Method	Description
`getTask(id)`	Get task status
`listTasks(status?)`	List tasks (optionally filter)
`cancelTask(id)`	Cancel a running task
`getTaskJournal(id)`	Get task logs
`getLogs(params)`	Query journal logs with filters

User

Method	Description
`getUser()`	Get current user info

Links

Website: dollardeploy.com
CLI Docs: docs.dollardeploy.com
API Reference: dollardeploy.com/apidocs
GitHub: github.com/dollardeploy
Discord: Join our community

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
README.md		README.md
deploy.js		deploy.js
package-lock.json		package-lock.json
package.json		package.json

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

@dollardeploy/cli

Installation

Quick Start

1. Get an API Key

2. Authenticate

3. Deploy

Host Lifecycle

Commands

ddc auth

ddc user

ddc host list

ddc host create

ddc host provision <id>

ddc host test <id>

ddc host prepare <id>

ddc host service

ddc host deprovision <id>

ddc host destroy <id>

ddc host remove <id>

ddc provision

ddc deploy

ddc build

ddc app list

ddc app remove <id>

ddc template list

ddc ssh add

ddc ssh list

ddc ssh remove <id>

ddc task

ddc logs

Global Options

JSON Output (AI Agent Friendly)

Environment Variables

Provider Defaults

CI/CD Integration

GitHub Actions

Programmatic Usage

API Client Methods

Hosts

Provisioning

Services

Apps

SSH Keys

Templates

Tasks

User

Links

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`ddc auth`

`ddc user`

`ddc host list`

`ddc host create`

`ddc host provision <id>`

`ddc host test <id>`

`ddc host prepare <id>`

`ddc host service`

`ddc host deprovision <id>`

`ddc host destroy <id>`

`ddc host remove <id>`

`ddc provision`

`ddc deploy`

`ddc build`

`ddc app list`

`ddc app remove <id>`

`ddc template list`

`ddc ssh add`

`ddc ssh list`

`ddc ssh remove <id>`

`ddc task`

`ddc logs`

Packages