For LineageOS and AOSP-derived ROM users on eSIM-capable hardware, worldwide.
eSIM on LineageOS and other AOSP builds
Official LineageOS builds generally ship no local profile assistant. Without one, there is no software on the phone that can fetch a profile, so the eSIM chip in your handset sits there unreachable. This page explains exactly why, and how to check your own build in two minutes.

- Official LineageOS builds generally include no local profile assistant, so profiles cannot be downloaded
- An EID from *#06# proves the eUICC chip exists and proves nothing about software support
- OpenEUICC needs system privilege or ARA-M allowlisting, so it must be in the ROM or added via Magisk
- EasyEUICC installs as a normal app but cannot manage a phone's built-in eSIM
- Support varies per device build, so check the build you are running rather than the ROM family
- Test your device before paying anyone: our UK number QR is single use and is never reissued
Start with the answer, because hedging here wastes your time and can cost you money. On most official LineageOS builds you cannot download an eSIM profile. The reason is not a bug, a missing driver or a carrier restriction. It is that Android's open-source core deliberately does not include the application that performs the download, and LineageOS, being a faithful AOSP derivative, does not add one. Google's Android does include it. Lineage does not, and it never promised to.
The component in question is called a local profile assistant. It is the thing that takes an activation code, opens a connection to the operator's provisioning server, proves the device is genuine, and writes the resulting profile into the eUICC, the tiny secure chip that stores eSIM identities. Android exposes framework interfaces for talking to that chip, but interfaces are plumbing, not a tap. Somebody has to ship the actual assistant as a privileged system application, and on a stock Pixel that somebody is Google.
Hardware capability and OS capability are different questions
Your phone almost certainly has the chip. Any handset sold with eSIM has a physical eUICC wired to the modem, and flashing a different Android over the top does not remove it. You can prove it in seconds by dialling *#06# and reading off the EID, a 32-digit number that identifies the chip rather than the phone. People see that EID, conclude the device supports eSIM, and then cannot understand why nothing in Settings lets them add one.
The EID is telling you about silicon. The missing menu is telling you about software. Both statements are true at once: the hardware is eSIM-capable and the operating system cannot use it. No provider can sell you around this, no activation code is special enough to fix it, and no support ticket will help, because the limitation lives in the image you flashed rather than in the profile. That is why the check further down this page exists, and why it costs nothing to run.
OpenEUICC, and why an app from an app store is not enough
There is an open-source answer. OpenEUICC is a free software local profile assistant for Android, and it is what several de-Googled ROMs use in place of Google's implementation. iodeOS adopted it, and the now-discontinued DivestOS shipped it before that. The catch is in the project's own one-line description: system privilege or ARA-M allowlisting is required. OpenEUICC has to be installed as a system application, which means it must be built into the ROM image or injected as a Magisk module. It is not something you install like a normal app and expect to work.
The project also publishes EasyEUICC, an unprivileged variant that does install like a normal app, and this is where people get their hopes up wrongly. EasyEUICC cannot manage a phone's internal eSIM. It works with removable eSIM chips and USB readers, and only where the chip proactively grants it access through its ARA-M field. Built-in eUICCs do not do that. So downloading EasyEUICC onto stock LineageOS and expecting to add a profile to the handset's embedded chip will not work, and no amount of retrying changes it.
What to do instead
If your build has no assistant, you have three realistic options and one dead end. You can move to a ROM that ships one, which in practice means a build that has integrated OpenEUICC or a de-Googled OS that carries Google's implementation in a disabled-by-default state. You can look for an unofficial build of your device that includes OpenEUICC as a system app, remembering that unofficial builds vary enormously in quality and that you are trusting whoever compiled it. Or you can add OpenEUICC via Magisk if your device is already rooted and you accept the risk that entails.
The dead end is buying an eSIM first and hoping. A physical SIM is the honest answer for an unsupported build, and we do not sell physical SIMs, so this is advice with nothing behind it. If you do change ROMs specifically to get eSIM working, do the change and confirm the download screen appears before you pay anyone for a profile. Build support also moves: some device builds have gained eSIM screens over time, so a two-year-old forum post about your model may simply be stale in either direction. Check the build in front of you.
What we can promise and what we cannot
We supply a standard GSMA activation code. Whether your operating system can consume it is determined entirely by your build, and we have no visibility into and no control over that. We sell the eSIM profile, we do not control whether a given ROM can install it, and on this page more than any other that distinction decides whether you should buy at all. Test first. If the add-a-SIM screen is not there, do not pay us.
Concretely: the UK number QR is single use and is never reissued, and the purchase is not refundable if your ROM turns out to be unable to download it. Ask us before paying if you are unsure, and we will tell you plainly whether we have seen your combination work. On verification generally, the line receives ordinary SMS and voice calls, but no provider can guarantee that any particular app or service will accept any particular number.
Find out in two minutes whether your build can download a profile
- 1
Confirm the chip exists
Dial *#06# and look for a line labelled EID, a 32-digit number distinct from the IMEI. Settings > About phone shows it on some devices instead. An EID means the eUICC hardware is present. It does not mean the operating system can reach it, and this is the single most misread signal in the whole process.
- 2
Look for the download path in Settings
Open Settings > Network & internet > SIMs. You are looking for a plus button, an entry that says something like Add eSIM, or an option to download a SIM instead of inserting one. If the flow opens a QR scanner and offers to accept a manually typed activation code, your build has a working assistant. If Settings only ever talks about physical cards, it does not, and that is your answer.
- 3
Check for a profile assistant package
For a more definitive read, list the system packages and look for one. With adb connected, run: adb shell pm list packages | grep -i euicc . A result containing euicc indicates an assistant is installed as a system app. An empty result on an official LineageOS build is the expected outcome and confirms the diagnosis. Without adb you can approximate this in Settings > Apps by enabling the option to show system apps and searching for eUICC.
- 4
If nothing is there, change the ROM rather than the eSIM
No provider can fix a missing assistant, so the fix is on your side. Look for an unofficial build of your exact device that integrates OpenEUICC, move to a de-Googled OS that ships an assistant, or add OpenEUICC as a Magisk module if the device is rooted. Do not install EasyEUICC expecting to use the built-in chip, because it can only manage removable eSIMs that explicitly allowlist it.
- 5
Re-run the check after any ROM change, then get a code
Repeat step two on the new build and confirm the scanner actually opens before spending anything. Only then buy a profile. Ours is a real UK +44 mobile carrier line at $25 one time with the first six months included and $15 every six months after, paid in crypto with no KYC, no account and no email, delivered as a QR on screen once the payment confirms. It takes unlimited incoming SMS and calls worldwide and carries no mobile data. Travel data is a separate product from $1.99.
- 6
Handle a failed download without destroying the profile
If the scanner opens but the download errors, write down the exact message, reboot once, and retry on a different network. Do not delete a partially installed profile and do not rescan repeatedly, since some servers treat a code as consumed after the first successful handshake. Contact whoever issued the code before removing anything.
Questions & answers
Can I install an eSIM on LineageOS?
On official builds, usually not. They ship without a local profile assistant, which is the software that downloads a profile onto the phone's eUICC, so there is nothing on the device capable of performing the download. The hardware is fine and the operating system simply cannot reach it. Check your own build before buying any eSIM from anyone.
My phone shows an EID, so why can I not add an eSIM?
The EID identifies the embedded SIM chip, so seeing one only confirms the hardware is present. Downloading a profile onto that chip is a separate software job performed by a local profile assistant, which official LineageOS builds do not include. Hardware capability and operating system capability are two different questions and they can disagree.
Can I just install OpenEUICC from an app store?
No. OpenEUICC has to run as a privileged system application, meaning it must be compiled into the ROM or added through a Magisk module on a rooted device. The project also publishes EasyEUICC, which installs without privileges, but that variant only manages removable eSIM chips and USB readers that explicitly allowlist it, and built-in eSIMs do not.
Which de-Googled systems do include an eSIM downloader?
iodeOS integrated OpenEUICC, and the discontinued DivestOS shipped it before shutting down. Some unofficial LineageOS builds include it and many do not. Other de-Googled systems instead carry Google's implementation, working but not open source. Verify the specific build you plan to flash, because this changes release by release.
Will you refund me if my ROM cannot install the profile?
No, and we would rather you did not get into that position. The UK number QR is single use and is never reissued, and the purchase is not refundable on compatibility grounds. We sell the eSIM profile and we do not control whether a given ROM can install it, which is why we ask you to run the check on this page first and to contact us before paying if anything is unclear.
More topics
eSIM on LineageOS and other AOSP builds
Official LineageOS builds generally ship no local profile assistant. Without one, there is no software on the phone that can fetch a profile, so the eSIM chip in your handset sits there unreachable. This page explains exactly why, and how to check your own build in two minutes.
Buy UK eSIM - $25