Frequently Asked Questions
Installation
- The most common reasons for this error are:
- You are trying to install a build for a different device. You need to make sure you download the zip for the correct device and variant
- You are attempting to migrate from an unofficial build to official LineageOS. A full data wipe is needed if you are coming from something other than an official build of LineageOS.
- Your vendor/modem/bootloader is too old (or maybe too new). Flash the correct stock image for your device, before wiping data and attempting to install LineageOS again. This information should be listed on the device’s wiki page.
- Your recovery is outdated. Flash the newest available version of the recommended recovery image for your device.
- If your error still persists after confirming these are not causing your issue, ask someone for help on IRC #lineageos@Libera.Chat or on the subreddit and provide a recovery log.
/data/lineageos_updates/
Few devices allow for it and even less work properly after that. Relocking can result in actual unusable devices, so be warned!
Sorry, as per the question right above, we don’t support this usecase and there may not be a good way to recover. XDA, other similar forums or a search engine may be of use.
Downloads
Be patient. Devices are slowly being built throughout the week. Maintainers have busy lives, and sometimes an issue is holding it back. Please do not ask for ETAs.
- The download portal exposes various images for our devices. Some are required for the installation or upgrade process (which you can read up on your device’s instructions), some are just there and might help us when we try to debug or fix an issue for you.
- If they aren’t mentioned on your device’s wiki pages, just ignore them!
- In short, you can’t. We don’t build more than 2 versions usually (exemptions were made when major hurdles prevented a large amount of devices to receive a newer version) and we don’t keep old builds around for a multitude of reasons, the largest being that we won’t keep old, insecure, potentially broken builds around. Additionally, we don’t have the server space (or the space on mirrors) to do so.
- There might be archives in the wild and you can check if they are actually signed by LineageOS here. Please don’t expect us to provide any support for them, though, beyond what we offer on this wiki!
Occasionally a build is broken. If this happens, we remove it until the next build cycle. It is also possible the device is no longer in the official build roster and its old builds are being purged, or that the version it supported is no longer supported. You can check your device’s wiki page to confirm support status.
Device support
- All devices are maintained by open source contributors - sorry, we don’t take device requests. If you would like to bring-up LineageOS for a device, and can meet some basic standards, we’ll happily look into making it official.
- If you would like to submit your device tree and kernel for official builds, please take a look at Submitting a port page.
- If your device is not listed, it’s not supported.
- “The same” is not “equal” which means it needs a separate build
- We try to keep the list of supported models as comprehensive as possible and effectively do not support any that are not listed.
- If your model is not listed, it is not supported. We do not keep track of the reasoning for which models are supported and which are not, so please don’t ask!
If it’s on this list, we do, otherwise not.
- All devices must meet our Device support requirements.
- If something doesn’t work, look into How to submit a bug
Because all maintainers are volunteers doing this in their free time, and someone happened to love this device enough to bring it up and properly support it.
- There are none
- See what other, similar devices did to get them to work.
Bugs and features
You can report it! Please carefully read the How to submit a bug page before reporting it.
- Short: Don’t ask
- Longer: We are doing this in our free, unpaid time. Thus, we don’t take feature requests and simply work on our own ideas.
Finding other people that have your issue, especially on other devices, is not helpful to solving it. Instead, to best help us solve the issue, please report it properly as shown here.
- We can’t provide support for any third-party modifications or software since we don’t maintain it.
- Ask whoever provided it to you, because it’s their work.
Common issues
Some devices pass their bootloader unlock status and verity status to Android’s kernel during boot. We don’t purposefully remove those flags, as it isn’t our place to lie about security features. There’s also a blog post about this topic, which explains our reasons further.
- We only provide help for officially supported devices for which we provide our own guides. Follow those instead!
- If you follow the official guide for your device line-by-line and still experience issues, feel free to ask again.
Advanced topics
This question isn’t new. To list a few reasons:
- A majority of builds are downloaded on mobile devices via our updater. Mobile devices have limited bandwidth and monthly quotas.
- Bandwidth is plentiful for open source projects. We have roughly 100gbit available to us.
- We occasionally need to remove a build because of a device-breaking bug. This is much harder, or impossible, to accomplish with torrents.
- We currently keep the last 4 builds per device. Older builds do not have the latest security patches.
- The top 5 devices account for 50% of our users. 95% of our builds do not have enough users to justify torrents.
- Pigeons are slow and stupid. They also tend to be hit by vehicles and make a delicious treat for predators. We could send your build via pigeon, but chances are very slim it would make it to you.
We can’t tell you. ‘No ETA’ includes the ‘IF’, not just the ‘WHEN’