Skip to main content
Use the run.cloud CLI to authenticate, create iOS simulator sessions, upload app artifacts, and release sessions from your terminal or CI.

​
Install

npm install -g run-cloud
# or
npx run-cloud ios create

​
Authenticate

run.cloud uses the same browser-authenticated CLI token format as Newly: 
run-cloud login
For CI, provide a CLI token: 
run-cloud login --token "$RUN_CLOUD_CLI_TOKEN"

​
Create a simulator

run-cloud ios create
The command returns a signed browser URL, device id, lease id, and session id. For scripts, prefer JSON: 
SESSION_ID=$(run-cloud ios create --json | jq -r '.id')
run-cloud ios get "$SESSION_ID" --json
See Run an iOS Simulator for the full simulator command reference.

​
Upload and install an app

run-cloud ios create --install ./MyApp.tar.gz
--install accepts .tar.gz, .zip, .app archives, and .ipa files. iOS Simulator reliability still depends on the app being built for the simulator runtime. Device-signed App Store IPAs are not a substitute for simulator builds. You can also upload once and reuse the asset: 
run-cloud asset push ./MyApp.tar.gz -n my-app
run-cloud ios create --install-asset my-app

​
Clean up

run-cloud ios list
run-cloud ios delete <session-id>
Sessions are metered while active. Explicit release charges the final started minute. If the account balance reaches zero, active sessions are closed automatically.