FAQ

Why Is My Agent Not Showing Up As Online?

Check these first:

• the install script used the correct backend URL and agent token

• the agent host can reach the backend

• OPEN_DEVICE_CLOUD_AGENT_HOST resolves from both the backend and the browser

• platform prerequisites such as vphone-cli or Android SDK tools are actually installed

Why Can I Not Create An iOS Device Without image_id?

iOS device creation requires a managed image. Import a prepared VM first or capture an existing stopped device into a managed image.

Why Do Android Images Show Up Automatically?

Android SDK system images are discovered directly from ANDROID_SDK_ROOT/system-images. They behave like available source images even before you capture any custom snapshots.

Why Can I Not Rename Or Delete Some Android Images?

SDK-discovered Android images are inventory derived from the local SDK installation. They are not managed copies, so rename and delete operations are rejected for those entries.

Where Does The Agent Store Runtime Data?

By default, under:

$HOME/.open-device-cloud

The installer creates separate directories for iOS VMs, Android VMs, and managed image stores.

Is The MCP Endpoint Under /api?

No. The MCP server is exposed at /mcp.

Does The Project Support Public Internet Exposure?

Not yet. The repository warning in the main README is intentional: v0.1.0 should be treated as an internal or lab deployment until authentication and hardening are more complete.