github gitlab mastodon email rss
LineageOS - fix vendor mismatch error

During the last LineageOS update, after having rebooted the phone I got a message saying “ensure your vendor image matches OMP7.18.1005.003”. After a little bit of research I fixed it easily, the reason for that to happen is that LineageOS doesn’t ship vendor, bootloader or radio as part of the update. So it has to be done manually.

The first thing is to identify the version of the image that you need, for my bullhead (Nexus 5X) I needed “OMP7.18.1005.003”, so I went to the factory images and downloaded that particular file. But this will change next time as the factory image get updated. The thing is to make the version match the one mentionned in the message.

Once this is done, it’s easy.

First step : checking the hash of the archive we have just downloaded.

$ sha256sum bullhead-opm7.181005.003-factory-e23fac1c.zip
e23fac1c7995e47e12823e3db577bb16f19894cb80545d3103e0087a396a1d2f
# e23fac1c is the beginning of the hash and what's provided in the filename

Second step : we unarchive it so we can browse it content.

$ unzip bullhead-opm7.181005.003-factory-e23fac1c.zip
$ cd bullhead-opm7.181005.003/
$ unzip image-bullhead-opm7.181005.003.zip
$ ~/downloads/bullhead/bullhead-opm7.181005.003$ ls -l
total 3240928
-rw-r--r-- 1 user users        101 Jan  1  2009 android-info.txt
-rw-r--r-- 1 user users   12068070 Jan  1  2009 boot.img
-rw-r--r-- 1 user users    4731396 Sep 21 21:04 bootloader-bullhead-bhz31b.img
-rw-r--r-- 1 user users        977 Sep 21 21:04 flash-all.bat
-rwxr-xr-x 1 user users        932 Sep 21 21:04 flash-all.sh
-rwxr-xr-x 1 user users        878 Sep 21 21:04 flash-base.sh
-rw-r--r-- 1 user users 1028674328 Sep 21 21:04 image-bullhead-opm7.181005.003.zip
-rw-r--r-- 1 user users   57989632 Sep 21 21:04 radio-bullhead-m8994f-2.6.41.5.01.img
-rw-r--r-- 1 user users   17847530 Jan  1  2009 recovery.img
-rw-r--r-- 1 user users 2002471632 Jan  1  2009 system.img
-rw-r--r-- 1 user users  194892768 Jan  1  2009 vendor.img

Third and last step, apply the updates to the phone. Make sure your device is seen by fastboot utility.

$ adb reboot bootloader
$ fastboot flash vendor vendor.img
$ fastboot flash bootloader bootloader-bullhead-bhz11l.img
$ fastboot flash radio radio-bullhead-m8994f-2.6.37.2.21.img
$ fastboot continue

Now you should get your LineageOS starting properly, without this warning message anymore.