Android App

Turn any Android phone into an SMS gateway with the Ender app.

Requirements

  • Android 8.0 (Oreo) or higher
  • Active SIM card with SMS capability
  • Internet connection (WiFi or mobile data)

Installation

Option 1: Download APK

  1. Go to GitHub Releases
  2. Download the latest ender-vX.X.X.apk
  3. Enable "Install from unknown sources" in your phone settings
  4. Open the APK to install

Option 2: Build from source

git clone https://github.com/ender-sms/android.git
cd android
./gradlew assembleRelease

Setup

1. Open the app

Launch Ender and tap "Get Started".

2. Enter server URL

Enter your Ender server URL:

https://sms.yourdomain.com

3. Log in

Enter your Ender account credentials.

4. Grant permissions

The app will request the following permissions:

  • Send SMS - Required to send messages
  • Receive SMS - Optional, for incoming message webhooks
  • Read phone state - To detect SIM status
  • Run in background - To process messages when app is closed

Important: Disable battery optimization for Ender to ensure reliable message delivery when the screen is off.

Battery optimization

Android aggressively kills background apps. To prevent this:

  1. Go to Settings → Apps → Ender
  2. Tap "Battery"
  3. Select "Unrestricted" or "Don't optimize"

On some phones (Xiaomi, Huawei, Samsung), you may need additional steps. See Don't Kill My App for device-specific instructions.

Troubleshooting

App shows "Disconnected"

  • Check your internet connection
  • Verify the server URL is correct
  • Make sure your server is running

Messages stuck in "Sending"

  • Check if the SIM card has SMS credits
  • Verify the phone number format
  • Check the Android SMS app for errors

App killed in background

  • Disable battery optimization
  • Lock the app in recent apps (on supported devices)
  • Add the app to any "protected apps" list

Next steps