Reference

Troubleshooting

The most common errors and the exact fixes.

`apirex doctor` is your first stop

It diagnoses 90% of install issues automatically and prints the exact fix.

Build fails with SDK error

bash
apirex doctor --fix

Agent won't connect

Check your firewall on outbound TLS (443) and run `apirex login` again to refresh your token.

App is too large

Enable R8 minification and resource shrinking in Project settings → Build. Most apps drop 40–60% in APK size.

Crash on launch

90% of cases are missing env values. Set them in `app/local.properties` and rebuild.