# Cloud Upload an app binary and run Maestro flows on DeviceCloud. This is the primary command and a drop-in replacement for `maestro cloud`. ```bash dcd cloud [flags] ``` The command blocks until all tests have completed, then exits with an appropriate [exit code](/advanced/exit-codes.md). ## Arguments | Argument | Description | | ------------- | ---------------------------------------------------------------------- | | `` | Path to your app binary (`.apk` for Android, `.app` or `.zip` for iOS) | | `` | Path to the flow file or directory of flows to run | ## Flags ### Authentication | Flag | Description | | ----------------- | -------------------------------------------------------------------- | | `--api-key ` | Your DeviceCloud API key. Defaults to `DEVICE_CLOUD_API_KEY` env var | ### App | Flag | Description | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--app-binary-id ` | Reuse a previously uploaded binary instead of uploading again | | `--app-url ` | Signed URL to an Expo iOS build (`.tar.gz`). The archive is downloaded and extracted automatically. Expo signed URLs expire after \~1 hour. Mutually exclusive with `--app-file` | | `--additional-app-files ` | Comma-separated list of additional app files to upload | | `--additional-app-binary-ids ` | Comma-separated list of additional binary IDs to include | | `--ignore-sha-check` | Force re-upload even if a binary with the same SHA already exists | ### Device | Flag | Description | | ----------------------------- | --------------------------------------------------------------------------------------------- | | `--android-device ` | Android device model to run on (see [Devices](/getting-started/devices-configuration.md)) | | `--android-api-level ` | Android API level | | `--ios-device ` | iOS device model to run on (see [Devices](/getting-started/devices-configuration.md)) | | `--ios-version ` | iOS version | | `--device-locale ` | Device locale (see [Device Locale](/configuration/device-locale.md)) | | `--orientation ` | Device orientation (see [Orientation](/configuration/orientation.md)) | | `--google-play` | Use a Google Play-enabled device (see [Google Play APIs](/configuration/google-play-apis.md)) | | `--runner-type ` | Runner type to use (see [Runner Types](/configuration/runner-type.md)) | ### Flows | Flag | Description | | ------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `--flows ` | Comma-separated list of flow files to run (alternative to positional arg) | | `--config ` | Path to a `config.yaml` workspace config file (see [Workspace Configuration](/configuration/workspace-config.md)) | | `--exclude-flows ` | Comma-separated list of flow files to exclude | | `--include-tags ` | Only run flows with these tags (comma-separated) | | `--exclude-tags ` | Skip flows with these tags (comma-separated) | ### Test Configuration | Flag | Description | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `--maestro-version ` | Maestro version to use (see [Maestro Versions](/configuration/maestro-versions.md)) | | `--env ` | Environment variables to pass to the test. Repeat for multiple values | | `--name ` | Name for this upload (shown in the console) | | `--retry ` | Retry failed tests up to `n` times. Max `2` (see [Retry Strategies](/advanced/retry-strategies.md)) | | `--report ` | Generate a report. Options: `junit`, `html`, `html-detailed`, `allure` (see [Report Formats](/test-results-and-artifacts/report-formats.md)) | ### GitHub / PR Context Attach Git and pull request metadata to a run. These values are displayed in the DeviceCloud console alongside the test results, making it easy to trace a run back to the exact commit or PR that triggered it. | Flag | Description | | -------------------------- | ------------------------------------------------------ | | `--branch ` | Git branch name for this run | | `--commit-sha ` | Git commit SHA for this run | | `--repo-name ` | Repository in `owner/repo` format (e.g. `acme/my-app`) | | `--pr-number ` | Pull request number | | `--pr-url ` | Pull request URL | ### Android-Specific | Flag | Description | | ----------------------------- | -------------------------------------------------------------------------------------------- | | `--maestro-chrome-onboarding` | Run Chrome onboarding before tests (see [Chrome Onboarding](/advanced/chrome-onboarding.md)) | | `--android-no-snapshot` | Disable snapshot restore at test start | ### Performance | Flag | Description | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | `--disable-animations` | Disable device animations during test execution. On Android, disables system animation scales. On iOS, enables Reduce Motion. | ### Output & Execution | Flag | Description | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | `--async` | Submit tests and return immediately without waiting for results (see [Async Execution](/advanced/async-execution.md)) | | `--quiet` | Suppress per-test output; print only the final summary | | `--json` | Output results as JSON. Exits `0` even on test failure | | `--json-file ` | Write JSON results to a file | | `--download-artifacts ` | Download test artifacts after completion (see [Artifacts](/test-results-and-artifacts/artifacts.md)) | | `--debug` | Enable verbose debug logging | | `--use-beta` | Use the beta version of the DeviceCloud runner | ## Examples **Android:** ```bash dcd cloud app.apk flows/ --android-device "Pixel 8" --android-api-level 34 ``` **iOS:** ```bash dcd cloud app.zip flows/ --ios-device "iPhone 16" --ios-version 18 ``` **Filter by tag:** ```bash dcd cloud app.apk flows/ --include-tags smoke ``` **Reuse a previously uploaded binary:** ```bash dcd cloud flows/ --app-binary-id 67894274-b789-4c1e-80d4-da8998998999 ``` **Save results to JSON:** ```bash dcd cloud app.apk flows/ --json-file results.json ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.devicecloud.dev/cli-reference/dcd-cloud.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.