Skip to main content

Unlocking the bootloader

KompaktOS needs an unlocked bootloader. A backup with mtkclient first is recommended.

1. Install ADB​

adb and fastboot let your computer talk to the phone over USB. Both come in Google's platform-tools.

With Homebrew, in Terminal:

brew install --cask android-platform-tools

2. Turn on USB debugging and OEM unlocking​

On the phone:

  1. Settings → About phone → tap Build number seven times. If the phone has a PIN, it asks for it.
  2. Settings → System → Developer options → turn on USB debugging.
  3. In the same list, turn on OEM unlocking.

OEM unlocking missing?

  • In Developer options, change Smallest width from 360 to 420. The layout hides the option at 360.

3. Connect​

Plug in the phone and run:

adb devices
  1. The phone asks Allow USB debugging?
  2. Tick Always allow from this computer and tap Allow.
  3. Run adb devices again: it should now say device.

Nothing listed? Try another cable: some cables only charge.

4. Unlock​

adb reboot bootloader
fastboot flashing unlock
  • The screen shows nothing: the confirmation is there, but the e-ink panel does not draw it.
  • Press Volume-Up to confirm.
  • The computer prints Start unlock flow.
  • It takes about 12 seconds.

5. Check​

fastboot getvar unlocked
  • It should answer unlocked: yes.
  • The phone stays in the bootloader: go straight to Install, step 1 and use the Already in the bootloader tab.

Relocking is only possible with MuditaOS-K installed, do not try to relock LineageOS.

If fastboot sees nothing​

  • Check with fastboot devices, not adb devices. adb does not run in the bootloader, so adb devices shows nothing there even when all is well.
  • Try another cable. A cable can work for adb and still fail in fastboot. If fastboot devices lists nothing, suspect the cable first.
  • On a Mac, allow the accessory. The bootloader shows up as a new USB device, so macOS asks again whether to allow it to connect.
  • On Windows, install Google's USB driver. Windows has no driver for the bootloader, so fastboot devices lists nothing even when adb works.
    1. Download the Google USB Driver and extract the zip.
    2. With the phone in the bootloader, open Device Manager. The phone is listed with a warning icon, as Android or under Other devices.
    3. Right-click it → Update driver → Browse my computer for drivers → pick the extracted usb_driver folder → Next.
    4. It installs as Android Bootloader Interface. Run fastboot devices again.