Install & troubleshooting

Aurora is Android-only for now and installed by sideloading (no Play Store yet). It takes a couple of minutes. Here's exactly what to expect — including the prompts that look scary but are normal.

Before you start:

You need Android 10 or newer and about 143 MB free. This is a pre-alpha build for testers — please don't rely on it for sensitive communication yet.

Installing

Download the APK

Tap the download button above on your Android phone (or transfer the file to it).

Allow installing from this source

When you open the APK, Android asks whether to allow installs from this source (your browser or Files app). This prompt is normal for any app outside the Play Store — allow it to continue. You can turn it back off afterward.

If you see a Play Protect warning

Google flags any app it hasn't seen widely before, which includes a new sideloaded app like Aurora. You can choose to install anyway. If you'd like to be sure of what you downloaded, verify its signature below.

First launch & permissions

Aurora generates your private identity on-device, then asks for a few permissions. Notifications and Run in the background are required — they're what let messages and calls actually reach you when the app is closed. Camera and microphone are optional and only requested when you scan a code or start a call.

Add your first contact

One of you shows their QR code (Add contact → show code) and the other scans it; you each then confirm the short code shown on the other's screen. That mutual check is what makes pairing safe even if you shared the code online.

Verify your download (optional)

Every official Aurora APK is signed with the same certificate. To confirm a download is genuine, run apksigner verify --print-certs on it and check the SHA-256 matches:

f049428dbcd77228441f7dcd783f26b4891348f2f4592771a5d837f17871f624

(Tap to copy. keytool won't work — Aurora uses APK Signature Scheme v2/v3, not v1 JAR signing.)

Troubleshooting

My contact scanned my code but nothing happened.+
The pairing request travels through the rendezvous server, so both phones must be online, and the person being added must have allowed Notifications (so the request surfaces) and Run in the background. Have them open Aurora, confirm those permissions, then try the scan again.
I don't get messages or calls when the app is closed.+
Android may be putting Aurora to sleep. Allow it to run in the background / mark it "unrestricted" in your battery settings. On Xiaomi, Oppo, Vivo, and some Samsung phones you also need to enable Autostart for Aurora and remove any background restriction.
Messages won't reach someone far away.+
Pairing works across networks, but messages travel directly phone-to-phone. On some strict mobile networks (carrier-grade NAT) a direct connection can't form. Try Wi-Fi on at least one side. A relay-based fallback for these cases is on the roadmap.
The install was blocked entirely.+
Check Settings → Apps → Special access → Install unknown apps, and allow the browser or Files app you're installing from. Some managed/work profiles disable sideloading completely.

Still stuck? Email christiancorrea26@gmail.com with your phone model and Android version.