Dual-SIM APN settings not applying — configure via Blueprint JSON

Android

When managing dual-SIM devices through Esper and carrier-specific APN settings are missing or incorrect, data connectivity fails for one or both SIMs because the device has no valid access point configuration for those carriers.

Why this happens

Android does not automatically provision APN settings for all carriers on dual-SIM devices. Without a pushed APN configuration, the modem cannot establish a data connection for any SIM whose carrier APN is absent from the device. Esper delivers these settings through Blueprint JSON, but this requires the Supervisor Plugin to be active on the device before the configuration can take effect.

Before you begin

• Confirm your devices have dual-SIM capability and are enrolled in Esper.
• Obtain the MCC (Mobile Country Code) and MNC (Mobile Network Code) for each carrier from your carrier directly or from your SIM card documentation.
• Confirm you have admin access to the Esper Console.
• For Android 15 and above: identify your device OEM contact, as you will need them to sign the Supervisor Plugin APK.

Step 1: Install the Supervisor Plugin

APN configuration requires the Supervisor Plugin to be installed and active on your devices. The installation path depends on the Android version running on your fleet.

Android 14 and below

1. Contact Esper Support and request that the signed Supervisor Plugin be uploaded to your tenant. Provide your tenant name and the Android version of your devices.
2. Reboot your target devices after Esper Support confirms the upload is complete. The plugin activates automatically on reboot — no manual installation is required.

Android 15 and above

1. Contact Esper Support and request the unsigned Supervisor Plugin APK for your tenant.
2. Send the APK to your device OEM and request that they sign it using the device's platform keys. Platform signing grants the plugin the system-level permissions it needs to write APN settings.
3. Once the OEM returns the signed APK, send it to Esper Support. Esper Support uploads it to your tenant and confirms when it is ready to deploy.
4. Deploy the signed APK to your devices using a Blueprint as described in Step 3 below.

Step 2: Build the APN JSON configuration

Construct a JSON object containing one entry per carrier. Replace all placeholder values with the correct codes for each SIM before saving.

{
  "apns": [
    {
      "name": "Carrier 1 Name",
      "apn": "carrier1.apn.address",
      "type": "default,supl",
      "mcc": "CARRIER1_MCC",
      "mnc": "CARRIER1_MNC",
      "user": "",
      "password": "",
      "authtype": 0,
      "protocol": "IPV4V6",
      "roamingProtocol": "IPV4V6",
      "carrierId": -1,
      "enabled": true
    },
    {
      "name": "Carrier 2 Name",
      "apn": "carrier2.apn.address",
      "type": "default,supl",
      "mcc": "CARRIER2_MCC",
      "mnc": "CARRIER2_MNC",
      "user": "",
      "password": "",
      "authtype": 0,
      "protocol": "IPV4V6",
      "roamingProtocol": "IPV4V6",
      "carrierId": -1,
      "enabled": true
    }
  ]
}

• Leave user and password as empty strings if your carrier does not require authentication credentials.
• Verify MCC and MNC values with your carrier before deployment. Incorrect codes create APN entries the modem will not match to any SIM, and data will not connect.
• Keep type set to default,supl for standard dual-SIM data configurations unless your carrier specifies otherwise.

Step 3: Apply the configuration via Blueprint

1. In the Esper Console, navigate to Blueprints and select an existing blueprint that targets your device group, or create a new one.
2. Within the blueprint, go to Esper Settings → Advanced Android Settings.
3. Enable the Enable JSON toggle. This unlocks the JSON input field where custom settings are passed directly to the Esper Agent.
4. Paste the complete APN JSON you built in Step 2 into the JSON field, replacing any existing content.
5. Click Save to save the blueprint.
6. Apply the blueprint to a single test device first before deploying fleet-wide. Navigate to Devices & Groups, select the test device, and apply the blueprint from the device detail view.

Step 4: Validate APN settings on the test device

1. On the test device, open Settings → Network & Internet → SIM cards → [Carrier Name] → Access Point Names. The path may vary slightly by device manufacturer.
2. Confirm both APN entries appear and match the names and APN addresses you defined in the JSON.
3. Enable mobile data on each SIM individually and confirm a data connection is established. A working connection confirms the APN was accepted by the modem.
4. In the Esper Console, check the Activity Feed for the test device to confirm the blueprint was applied without errors.

Verify: Both APN entries appear under each SIM's APN settings on the device, mobile data connects successfully on each SIM, and the Activity Feed shows the blueprint applied without errors. Once confirmed on the test device, apply the blueprint to the full device group.

If this doesn't resolve it

If APN entries do not appear on the device after applying the blueprint, or data still fails to connect, collect the following before contacting Esper Support:

• The Android version and device model of the affected devices.
• Confirmation of whether the Supervisor Plugin is installed and active (visible under Devices & Groups → [Device Name] → Apps).
• A copy of the exact JSON you applied.
• The MCC and MNC values as confirmed by your carrier.
• A screenshot of the Activity Feed entries for the affected device around the time the blueprint was applied.

Contact Esper Support with this information to investigate further.

Still need help?

If the steps above don't resolve the issue, submit a support ticket with your device model, Android version, Esper Agent version, and a description of what you've already tried — this helps the support team investigate without a follow-up.