Dockhand Apps

Manage day-to-day application lifecycle operations. List apps, check status, manage domains, and perform lifecycle actions.

Configuration Context

IMPORTANT: When working with domains, always use the user's configured platform_domain from their dockhand config, NOT example placeholders. To discover the user's domain:

•Check existing DNS records via dns_list_records - domains will show the actual configured zone
•Check existing apps via dokploy_list_apps - app domains reveal the platform domain
•The user's config at ~/.config/dockhand/config.json contains platform_domain

Replace <platform_domain> in examples below with the user's actual domain (e.g., mycompany.com).

Application Overview

List all managed applications:

code

dokploy_list_apps
  → Returns all projects and applications
  → Includes status, domains, deployment info

Output format:

code

## Applications

| App           | Status  | Type      | Domain                    |
|---------------|---------|-----------|---------------------------|
| ghost         | running | stack     | <platform_domain>         |
| client-portal | running | compose   | portal.<platform_domain>  |
| wordpress     | running | stack     | client-site.com           |
| cal-com       | stopped | compose   | cal.<platform_domain>     |

Application Status

Get detailed status for specific app:

code

dokploy_app_status app_id="<app_id>"
  → Container state, replicas, health
  → Environment variables (names only)
  → Domains and routing
  → Recent deployment history

Lifecycle Operations

Start/Stop/Restart

Control app state via Dokploy:

code

# Restart (most common for applying changes)
dokploy_redeploy app_id="<id>" confirmed=true

# Stop (via Dokploy UI - not directly exposed)
# Start (via Dokploy UI - not directly exposed)

Note: Direct start/stop requires Dokploy UI. Redeploy handles most restart scenarios.

Scale Replicas

For stack-mode apps, adjust replicas:

•Update compose file in Dokploy
•Redeploy to apply changes

Domain Management

List Domains

code

dns_list_records type="CNAME"
  → All CNAME records (app domains)

dns_list_records type="A"
  → A records (root domains)

Add Domain to App

•

Create DNS record:

code

dns_create_record type="CNAME" name="new-app" content="platform-core.<your_domain>" confirmed=true

•
Add domain in Dokploy UI

•

Verify propagation:

code

dns_check_propagation domain="new-app.<your_domain>"

•

Check certificate:

code

traefik_check_certs domain="new-app.<your_domain>"

Update Domain

code

dns_update_record record_id="<id>" content="new-target.<your_domain>" confirmed=true

Remove Domain

code

dns_delete_record record_id="<id>" confirmed=true

Update Tracking

Track software updates across applications:

Check Update Status

code

updates_tracker action="status"
  → Last check time per app
  → Available updates

View Update Report

code

updates_tracker action="report"
  → Formatted update report
  → Prioritized by age/severity

Record Update Check

code

updates_tracker action="record" app_name="ghost" current_version="5.82.0" latest_version="5.87.0"

State Synchronization

Keep git documentation in sync with live state:

code

dokploy_sync_state
  → Exports current Dokploy state
  → Writes to state-snapshots/
  → Ready for git commit

Run after:

•New deployments
•Configuration changes
•Domain updates
•Before/after maintenance

Common Workflows

Daily Operations

•Check status: /dh:status
•Review apps: dokploy_list_apps
•Check updates: updates_tracker action="status"

After Deployment

•Verify app: dokploy_app_status app_id="<id>"
•Check routing: traefik_status
•Test HTTPS: traefik_check_certs domain="<domain>"
•Sync state: dokploy_sync_state

Troubleshooting App Issues

•Check status: dokploy_app_status
•If unhealthy → /dh:troubleshoot
•If needs restart → dokploy_redeploy confirmed=true
•Verify recovery

Integration with Client Portal

For apps deployed via client-portal:

•Same tools apply (dokploy_app_status, etc.)
•MCP tokens scope to user's apps
•Billing tracked separately in portal