Quickstart

All you need is an Android APK. Connecting a GitHub repository is optional.

1. Open the dashboard

2. Upload an app

Drop an APK onto the dashboard or choose Upload app. A progress card shows the upload; choose Cancel to stop it. If the file is rejected, for example because it is not an APK or is too large, the reason appears on the same card.

Ramus then starts a device and installs the app. The card steps through Finding a device, Booting Android and Connecting video, and the app opens when video arrives. The APK must run on an x86_64 Android emulator; apps that need unsupported native libraries or device hardware may not run.

You can also choose Open blank device to explore a device without an app.

3. Use the app

Click and drag to tap and swipe, and type with your keyboard. Use the viewer's screenshot and device-log controls to see what the app is doing. If the app needs a camera or microphone, turn on yours with Camera & mic; see Camera and microphone.

Use Share to create a link for someone else. Anyone with that link can access the shared device. Choose End device when you finish; leaving the page does not end it. See Preview sessions.

Which file to upload

Upload the APK your own build produces. These commands each make one that installs on its own:

Project	Command
Kotlin, Java, or Compose	`./gradlew assembleDebug`
React Native	`./gradlew assembleRelease` in `android/`
Expo	`eas build -p android` with `"buildType": "apk"` in the build profile
Flutter	`flutter build apk`

If you only have an Android App Bundle (.aab), convert it to one universal APK set with bundletool and upload the .apks file:

bundletool build-apks --bundle app.aab --output app.apks --mode=universal

Ramus does not accept .aab files directly. An APK downloaded from an app store or mirror site, or copied off a phone, is often only one part of a split app. It fails with INSTALL_FAILED_MISSING_SPLIT because the rest of the app is missing.

Optional: connect GitHub

Install the Ramus GitHub App from the dashboard or Settings and select the repositories it can access. Open a repository in Ramus and enable Automatic PR previews.

Open a same-repository pull request, or push a commit to one that is already open. The Ramus comment tracks the build and links to the preview once it is ready. See Builds for supported project layouts and build troubleshooting.

Prefer your terminal or a coding agent? See CLI and agents.