@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>

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 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 destroy <id>`

Deprovision and permanently delete a host. This removes the VM from your cloud provider.

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 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 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

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("https://dollardeploy.com", process.env.DOLLARDEPLOY_API_KEY);

// 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
`deprovisionHost(hostId)`	Deprovision and delete

Services

Method	Description
`listServices(hostId)`	List installed services
`createService(hostId, type)`	Install 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

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
`getTaskJournal(id)`	Get task logs

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 2 Commits
README.md		README.md
deploy.js		deploy.js
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

@dollardeploy/cli

Installation

Quick Start

1. Get an API Key

2. Authenticate

3. Deploy

Commands

ddc auth

ddc user

ddc host list

ddc host create

ddc host prepare <id>

ddc host destroy <id>

ddc host remove <id>

ddc deploy

ddc build

ddc app list

ddc template list

ddc ssh add

ddc ssh list

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 prepare <id>`

`ddc host destroy <id>`

`ddc host remove <id>`

`ddc deploy`

`ddc build`

`ddc app list`

`ddc template list`

`ddc ssh add`

`ddc ssh list`

Packages