EasyEUICC

Frequently Asked Questions

App Usage

Why do I see “App not installed as package appears to be invalid” during installation?

You may have installed a third-party build of EasyEUICC from elsewhere.

Please uninstall and then reinstall the official version provided on this site to receive updates from the official channel.

This will not affect your eSIM profiles as they are stored on the eUICC card, not in the EasyEUICC app.

Why do I see “App not installed as package conflicts with an existing package.” during installation?

You may currently have a Debug Build of EasyEUICC installed, and you are trying to install a Release Build.

Please uninstall the currently installed EasyEUICC app and reinstall the Release Build.

This will not affect your eSIM profiles as they are stored on the eUICC card, not in the EasyEUICC app.

Why do I see “There was a problem parsing the package.” during installation?

If you see this, your Android device may not be compatible with the EasyEUICC app.

EasyEUICC requires Android 9 (API level 28) or higher to function.

Please ensure your device is running Android 9 or higher.

Where can I find the source code of the EasyEUICC app?

The complete source code of EasyEUICC is contained within the OpenEUICC project. 1

The source code of OpenEUICC is hosted on a self-managed Gitea, and you can access it via this link: gitea.angry.im/PeterCxy/OpenEUICC. 2

OpenEUICC is licensed under the GPLv3 ONLY license, and the copyright notice can be found at gitea.angry.im/PeterCxy/OpenEUICC#copyright.

  1. For details on the differences between OpenEUICC and EasyEUICC, please refer to gitea.angry.im/PeterCxy/OpenEUICC#readme. ↩︎

  2. Official read-only mirror of OpenEUICC is available at github.com/estkme-group/openeuicc. ↩︎

How do I update the EasyEUICC app?

Tip

EasyEUICC does not have a built-in auto-update feature.

Please access our site via the “Official Website” link within the app’s Settings page. 1

When accessed through the in-app link, you will see an update prompt and can download the latest version when a new version is released. 2

  1. This feature was added in EasyEUICC v1.5.0. ↩︎

  2. EasyEUICC typically releases a stable version (Release Build) every 12 to 24 weeks, but the exact timing may vary depending on the development cycle of new features and fixes. ↩︎

Are products with EasyEUICC in their names official products of this project?

“EasyEUICC” is the name of an open-source software project; we do not sell any hardware products under this name, nor do we authorize any brands to use this name for sales.

Therefore, any products on the market using “EasyEUICC” as their product name are not affiliated with us.

We currently have no plans for commercializing the project itself and do not grant permission to any third parties to use “EasyEUICC” as a trademark. 1

  1. This statement does not affect the rights of any third party to lawfully use “EasyEUICC” as a descriptive term in their products or services, such as “Compatible with EasyEUICC” or “Supports EasyEUICC”. ↩︎

Which eUICC cards are supported by EasyEUICC?

Please refer to the “EasyEUICC-compatible cards” 1 list on the site homepage for details.

  1. “EasyEUICC-compatible cards” are those that comply with the GSMA SGP.22 specification and MUST include this specific ARA-M SHA-1 value: 2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA. ↩︎

Why doesn’t EasyEUICC provide a device compatibility list?

Due to the restrictions described in our Privacy Policy, we do not collect user device information to maintain an up-to-date a device compatibility list.

Should I adjust EasyEUICC settings?

Default settings are optimal for most users. Unless there are specific needs (for example, to work around a device-specific bug), there shouldn’t usually be a need to adjust them.

Why does EasyEUICC request notification permission?

Notification permission is optional but improves user experience.

With notifications enabled, and when a profile is being downloaded, EasyEUICC can display progress in the notification bar while the app is in the background.

However, even without notification permission, EasyEUICC is still able to continue ongoing downloads while in background. In that case, a default notification will be shown by Android.

Will EasyEUICC be available on the Google Play Store?

Currently, there are no plans to release EasyEUICC on the Google Play Store 1, F-Droid 2, or any other similar platforms. 3

Please read “How do I update the EasyEUICC app?” to learn how to obtain the latest version of the app.

  1. Google Play Store is the official app store on Android devices that comply with Google Mobile Services (GMS) standards. ↩︎

  2. F-Droid is an Android app store focused on Free and Open Source Software (FOSS). ↩︎

  3. Amazon Appstore on Android has been discontinued as of August 20, 2025. For more details, please refer to amazon.com/b?node=210942225011. ↩︎

How to sponsor the EasyEUICC Project?

If you find the EasyEUICC project helpful, please use the EASYEUICC coupon code to purchase products from ESTKme or 9eSIM to support us.

We earn revenue from their Affiliate Program, which helps us continue to improve and maintain the EasyEUICC project.

I don’t have a eSIM QR code or activation code, can I download an eSIM profile via eSIM Discovery?

EasyEUICC does not support eSIM Discovery, so it cannot automatically discover or download eSIM profiles via an eSIM Discovery service. 1

If your carrier does not provide a eSIM QR code or activation code, you cannot download eSIM profiles using EasyEUICC.

  1. This feature relies on support and cooperation from multiple parties, including eUICC cards, carriers, etc. ↩︎

Carrier-related

What to do if a profile isn’t usable after downloading?

Note

Issues encountered after downloading a profile are unrelated to EasyEUICC and eUICC cards.
Please contact your carrier for further assistance.

DO NOT DELETE a profile you have already downloaded to your eUICC card. most carriers eSIM QR codes/activation codes are typically SINGLE USE ONLY.

If you deleted a downloaded profile, you will likely be unable to re-download it using the same eSIM QR or activation code.

We recommend contacting your carrier for assistance.

Why don’t features like Wi-Fi Calling, VoLTE, RCS, etc work?

Note

These features not related to EasyEUICC or the eUICC card. They are purely a carrier-side concern.
Please contact your carriers for further assistance.

Carriers often limit support for these features to certain devices / plans only. Please confirm with your carrier whether your device and/or plan is supported.

When do I need to enter a “Confirmation Code”?

Some carriers may require a “Confirmation Code” when downloading a profile. 1

A Confirmation Code is usually a 4 to 8 digit number used to verify your identity or authorize the profile download.

If the download is stuck at “Downloading eSIM profile”, enter the Confirmation Code and try again.

EasyEUICC does not currently support entering the Confirmation Code in the middle of the download process. Please make sure you have entered the Confirmation Code correctly before pressing the download button.

  1. Some carriers refer to “Confirmation Code” as “ePIN”. ↩︎

How to transfer a profile to a new card or device?

Important

Please DO NOT DELETE the downloaded profile before confirming how to transfer it, as with most carriers eSIM QR codes/activation codes are typically SINGLE USE ONLY.

If your profile is on a removable eUICC card, as most EasyEUICC-compatibles are, you do not need to do anything special other than moving the card to the new device.

Otherwise, contact your carrier to learn how to obtain a new eSIM QR or activation code.

You may also be able to use an existing code to download the same profile on to a new device or eUICC card. Again, please confirm with your carrier whether this is possible.

Troubleshooting

Why is EasyEUICC unavailable on some devices?

EasyEUICC depends on OMAPI 1, which is not available on all devices, or, in the case of some multi-SIM devices, only for some slots.

Minimum required Android version is Android 9 (API level 28). 2 3

  1. The Open Mobile API (OMAPI) is a standardized API that allows applications to communicate with secure elements such as eUICC cards.
    See As easy as Pie: Google’s Android implementation of OMAPI for details. ↩︎

  2. Android 9 adds an implementation of the GlobalPlatform Open Mobile API to Android.
    See Introducing Android 9 Pie for details. ↩︎

  3. Note that HUAWEI devices no longer claim full Android compatibility or even to be Android. Therefore, we do not provide support for HUAWEI devices.
    See gitea.angry.im/PeterCxy/OpenEUICC/issues/29#issuecomment-117 for details. ↩︎

My device has dual SIM slots. Why can’t EasyEUICC recognize cards in both slots?

Note

This issue is not related to EasyEUICC, but rather to your device manufacturer.

EasyEUICC itself supports dual SIM or even multiple SIMs. However, some devices only provide access to OMAPI on one of its slots, meaning that you can only manage EasyEUICC compatible cards 1 inserted in that slot.

You can check the “Accessible Slots” information in the “Compatibility Check” to understand this; usually, SIM 0 refers to the primary slot, and SIM 1 refers to the secondary slot.

  1. “EasyEUICC-compatible cards” are those that comply with the GSMA SGP.22 specification and MUST include this specific ARA-M SHA-1 value: 2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA. ↩︎

Why can’t I access the card anymore after enabling certain specific profiles?

Some eUICC cards have a bug where the ARA-M record is overridden by certain downloaded profiles, causing the device to no longer recognize the card.

If this action causes the eUICC card to become inaccessible, you can restore it using a smartcard reader.

My device runs hot and sluggish after switching profiles.

Note

This issue is not related to EasyEUICC but is associated with your device manufacturer.

On some Android devices, you may experience overheating and lagging after switching profiles. 1

This is due to a device-side bug and you may want to RESTART YOUR DEVICE after switching profiles.

  1. This issue has been reported on Samsung devices. ↩︎

Why can’t I disable or delete the active profile?

Warning

An eUICC card without an active profile may be inaccessible to some Android devices.
Please proceed with caution!

On some buggy Android devices and eUICC cards, disabling or deleting the active profile, i.e. causing the card to have no active profile, will prevent your device from recognizing the eUICC card at all.

To prevent this, EasyEUICC by default does not allow disabling or deleting the active profile. To delete a profile, please first switch to another profile on the card.

If you have only 1 single profile remaining on a card, it is therefore impossible to delete or deactivate that profile.

You can override this behavior via “Settings” ➞ “Allow Disabling / Deleting Active Profile”.

If this action causes the eUICC card to become inaccessible, you can restore it by downloading / activating a profile through a smartcard reader, or via another Android device that behaves properly with empty eUICC cards.

My profile isn’t active but I still can’t delete or disable it?

Some eUICC cards impose restrictions on specific profiles, preventing them from being DISABLED or DELETED.

This is usually a restriction set by the manufacturer of the eUICC card or the carriers, and can’t be overridden by EasyEUICC.

I disabled my eUICC card through the Settings app. Why can’t I re-enable it again?

Under certain conditions, you may encounter issues re-enabling a disabled, removable eUICC card. 1

As a result, please avoid using Android’s Settings app to enable, disable, or otherwise operate on any removable eUICC card.

To recover a disabled card, please run the following command on your computer to clear the data of Telephony Provider: 2 3

Warning

Please note that executing the command below will clear all phone-related data, including CONTACTS, MESSAGES, CALL LOGS, etc.
Please make sure you have backed up important data before continuing.

adb shell pm clear com.android.providers.telephony

  1. This typically happens when the eUICC flag is set in the ATR information of a removable eUICC card. Android’s Telephony stack assumes all cards with that flag to be irremovable, as such it refuses to re-enable it like a normal SIM card. ↩︎

  2. Reference xdaforums.com/t/4548895/post-89768555 ↩︎

  3. You need to have Android SDK Platform Tools installed on your computer and enable “Developer Options” and “USB Debugging” on your device. ↩︎

Why can’t I reorder my profiles?

The order of profiles cannot be changed because their order is determined by the card, not the app, as we do not keep any data about the profiles outside of the eUICC card.

The default order for most cards is usually the order in which profiles were downloaded on to the card.

Why isn’t full capacity shown for my ESTKme Max card?

Tip

Make sure you are using EasyEUICC v1.5.1 or later.

ESTKme Max cards contain multiple Secure Elements; correctly detecting and showing each SE’s capacity requires EasyEUICC v1.5.1 or later.

Where can I find the PIN and PUK codes?

Note

This issue is unrelated to EasyEUICC.
EACH PROFILE is assigned its own PIN / PUK code by the carrier.

You need to contact your carrier(s) to obtain the PIN and PUK code for each profile, as these codes are assigned and managed by them.

Please note that entering incorrect PIN and PUK codes multiple times in a row may result in the profile being PERMANENTLY LOCKED, so please proceed with caution. 1

If your profile is already locked, you need to contact your carriers to unlock the profile using the PUK or obtain a new profile.

  1. Up to 3 incorrect attempts are allowed for PIN and 10 for PUK. After 10 incorrect attempts of the PUK code, the profile will be PERMANENTLY LOCKED. ↩︎

What should I do if download fails with “An error occurred in your eSIM chip.” at the “Loading eSIM profile into storage” stage?

Please read carefully

There can be a number of causes for this issue. At this stage, the carrier has usually already allowed the profile to be downloaded to the eUICC card, but an error occurred during the loading process.
Because the carrier has already been contacted for download, you should avoid retrying too many times on the same device. eSIM QR or activation codes provided by carriers usually have a limited number of attempts, and frequent retries may invalidate the code. 1

We recommend checking in the following order:

  1. Check whether your eUICC card supports the features required by the carrier (such as 5G SUCI). 2
  2. If your device is MediaTek, try using a non-MediaTek device. Devices with some MediaTek SoCs may have compatibility issues with removable eUICC cards that can cause the download to fail. 3

  1. In some cases, the eSIM QR code/activation code allows only one download attempt. If this applies to your QR code or activation code, or if your code has otherwise become invalid, contact your carrier directly for assistance. ↩︎

  2. If your carrier requires 5G SUCI, your eUICC card must also support 5G SUCI in order to download the profile successfully. ↩︎

  3. This is a known issue with some MediaTek basebands, and cannot be fixed or mitigated at the application level. We recommend either using a device with a different SoC, or using a Smart Card Reader instead. ↩︎

Why is my smartcard reader not recognized?

Your smartcard reader may not comply with ISO/IEC 7816. Please use a reader that conforms to that standard.

EasyEUICC supports most smartcard readers that comply with ISO/IEC 7816.

Tested and compatible smartcard readers with EasyEUICC include:

  1. ESTKme Reader
  2. 9eSIM Card Reader
  3. Hirsch’s SCR3310 v2.0 1
  4. Hirsch’s uTrust 2700 R / uTrust 2700 F 2
  5. Hirsch’s uTrust SmartFold SCR3500 3
  6. HID OMNIKEY 3021 / OMNIKEY 3121

  1. Formerly known as “SCM SCR3310 v2.0” or “Identiv SCR3310 v2.0”. ↩︎

  2. Formerly known as “SCM CLOUD 2700 R/F” or “Identiv uTrust 2700 R/F”. ↩︎

  3. Formerly known as “SCM SCR3500” or “Identiv SCR3500”. ↩︎

Last updated on