Install CatRealm on Android
CatRealm is in open testing on Google Play, which is the easiest way to install it and get updates. If you'd rather not use the Play Store, you can download the app file (an APK) and install it yourself. It takes about two minutes.
How to install
-
Download the APK
Open this page on your Android phone and tap Download APK. If your browser warns that the file might be harmful, tap Download anyway. Browsers show this for every app downloaded outside the Play Store.
-
Open the file
When the download finishes, tap Open in the browser, or find CatRealm-1.9.4.apk in your Downloads or Files app.
-
Allow installs from your browser
The first time, Android blocks the install and says your phone isn't allowed to install unknown apps from this source.
- Tap Settings in that message.
- Turn on Allow from this source.
- Go back. The install screen comes back on its own.
-
Install
Tap Install. If Google Play Protect says the app is unrecognized, tap More details, then Install anyway. It shows this because CatRealm isn't on the Play Store yet. If it offers to send the app for a scan, either answer is fine.
-
Open CatRealm and sign in
Tap Open, or find CatRealm in your app drawer. Sign in with your CatRealm account, or add a self-hosted server by its address.
Optional: once CatRealm is installed, you can turn Allow from this source back off for your browser. You'll need to turn it on again for each update.
Getting updates
The beta doesn't update itself. When a new version is announced, come back to this page, download the new APK and install it over the old one. Do not uninstall CatRealm first: uninstalling erases this phone's encrypted device identity and it will need to be trusted again.
Known limits of this beta
- No push notifications yet. Messages arrive while CatRealm is open, but you won't get notifications when it's closed.
- Moving to the Play Store version later may require uninstalling this beta if the signing key changes. Your account and servers return when you sign in, but this phone's device trust and local settings reset, and encrypted DMs may require key recovery from another trusted device.
Troubleshooting
"App not installed" or "conflicts with an existing package"
An older CatRealm test build may be signed differently. Uninstalling fixes that conflict, but it also erases this phone's encrypted device identity. Make sure another trusted device can recover your encrypted DM keys before uninstalling; after signing in again, approve this phone as a new device.
Nothing happens when I tap the file
Open the file from your Files app instead of the notification. On some phones, especially Samsung and Xiaomi, the unknown-apps setting is under Settings → Apps → Special access → Install unknown apps. Pick the app you're opening the file from and allow it.
"There was a problem parsing the package"
The download didn't finish, or your Android version is older than 7.0. Delete the file and download it again over a stable connection.
Play Protect blocked it completely
Tap More details on the warning to find Install anyway. If that option is missing, your phone may be managed by work or school and only allow Play Store apps.