dcd upload

Upload an app binary to DeviceCloud and get back a binary ID. Use the binary ID in subsequent dcd cloud runs to skip re-uploading the same binary.

DeviceCloud deduplicates binaries by SHA checksum — if you upload the same binary twice, the existing ID is returned and no upload occurs. Encrypted uploads are only matched against your earlier encrypted uploads, so a binary you previously uploaded unencrypted is uploaded once more the first time it's encrypted.

dcd upload <app-file> [flags]

Arguments

Argument	Description
<app-file>	Path to your app binary: .apk for Android, .app or .zip for iOS, or an Expo iOS build archive (.tar.gz), which is extracted automatically

Flags

Flag	Description
--api-key <key>	Your DeviceCloud API key. Defaults to DEVICE_CLOUD_API_KEY env var
--app-url <url>	Signed URL to an Expo iOS build (.tar.gz), used instead of <app-file>. The archive is downloaded and extracted automatically
--ignore-sha-check	Force re-upload even if a binary with the same SHA already exists
--encrypt / --no-encrypt	Encryption is on by default (CLI 5.7.0 and later): the binary is encrypted on your machine before upload. Pass --no-encrypt (or set DCD_ENCRYPT=0) to upload it unencrypted
--json	Output the binary ID as JSON
--debug	Enable verbose debug logging

Examples

dcd upload app.apk

When the upload finishes, the CLI prints the binary ID:

✓ Upload complete
  ⎿ binary id   67894274-b789-4c1e-80d4-da8998998999
    Use this Binary ID in subsequent test runs with:
    dcd cloud --app-binary-id 67894274-b789-4c1e-80d4-da8998998999 path/to/flow.yaml

With --json, only the binary ID is printed:

dcd upload app.zip --api-key <key> --json

{
  "appBinaryId": "67894274-b789-4c1e-80d4-da8998998999"
}

Using Binary IDs

Uploading the binary separately is useful when running the same build across multiple test jobs — upload once, then pass --app-binary-id to each dcd cloud run:

# Upload once
BINARY_ID=$(dcd upload app.apk --json | jq -r '.appBinaryId')

# Run multiple jobs reusing the same binary
dcd cloud flows/smoke/ --app-binary-id $BINARY_ID --include-tags smoke
dcd cloud flows/regression/ --app-binary-id $BINARY_ID --include-tags regression