Install LuneOS for Hammerhead

From WebOS-Ports
Jump to navigation Jump to search

This guide will walk you through the process of taking the Nexus 5 from stock to having ability to flash the latest version of LuneOS.


Rules that you must agree to before using these images

Before you use our testing feeds, please read and agree to the following rules:

  1. Anyone participating in WebOS Ports alpha or beta testing of any kind must be prepared to fully erase and reflash their device at a moment's notice without warning and without any regrets or complaints.

  1. They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. If you are not intimately familiar with linux GO NO FURTHER
  2. They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
  3. They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
  4. They must read any and all documentation and forums threads (in their entirety) before asking a question.
  5. They must fastidiously follow the IRC Channel where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
  6. They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL http://testing-{{{device_name}}}
  7. When asking for help, they will include the phrase (which may change occasionally) "I've read and understand the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill. These images do NOT constitute a ROM, They are individual pieces and NOT intended or expected to be included in any ROM

Important Notes

The Nexus 5 (hammerhead) is the fifth Nexus phone manufactured by LG in cooperation with Google. Please note that you need to have CyanogenMod 12.1 ( !

Unlocking the device (bootloader)

First, the bootloader must be unlocked.

  1. Download and install the Android SDK for your platform from here: Android SDK
  2. Open a Terminal and: cd to <sdk>/tools/
  3. Run: ./android to start the Android SDK Manager
  4. Use it to install the latest version of 'Android SDK Platform-tools'
  5. Close the Android SDK Manager
  6. In your Terminal window,: cd to <sdk>/platform-tools/
  7. Power off the Nexus 5 and activate the bootloader (Vol Down & Power
    or adb reboot recovery)
  8. Connect it via USB
  9. In your Terminal window, run: ./fastboot devices
  10. If your device shows up, proceed to the next step. Otherwise, follow the instructions in this thread
  11. In your Terminal window, run: ./fastboot oem unlock
  12. A warning will appear on your Nexus 5, prompting you to unlock your bootloader.
  13. Use the Volume Up and Volume Down buttons to navigate and the Power button to confirm your selection.
  14. Reboot Device

Installing recovery using fastboot

You can use fastboot to install your recovery image to the device.

Installing ClockworkMod Recovery on the Nexus 5

  1. Your Nexus 5 should still be connected to your PC via USB from the last step
  2. Power off the Nexus 5 and activate the bootloader Vol Down & Power
    or adb reboot recovery
  3. Once the device is in fastboot mode, verify your PC sees the device by typing fastboot devices
  4. *If you don't see your device serial number, and instead see "<waiting for device>", fastboot is not configured properly on your machine. See fastboot documentation for more info.
  5. On your PC, download the ClockworkMod Nexus 5 recovery image (at time of writing,
  1. Flash CWM to your Nexus 5, making sure to use the proper filename for the image you downloaded:

 $ fastboot flash recovery recovery-clockworkmod-
 sending 'recovery' (6526 KB)...
 OKAY [  0.802s]
 writing 'recovery'...
 OKAY [  1.245s]
 finished. total time: 2.048s
 $ fastboot reboot
 finished. total time: 0.020s

  1. Reboot to bootloader, by powering off, then Vol Down & Power
    or adb reboot recovery
  2. Use the Volume Up or Volume Down key to select "Recovery mode", and the Power button to enter recovery.
  3. At this point, ClockworkMod should load.

Installing/Updating LuneOS from recovery


Some devices do not have removable SD cards. Regardless, there should still be a partition on the device named "/sdcard" that can be used for flashing purposes, even though the contents of /sdcard may actually be in internal storage.

  1. Your Nexus 5 should still be connected to your PC via USB from the last step
  2. Your Nexus 5 should still be booted to ClockworkMod from the last step
  3. If neither statement is currently true, please reboot to ClockworkMod. If you do not have CWM loaded, follow the steps outlined above.
  4. Download the latest stable LuneOS Dev-image or latest nightly LuneOS Dev-image
  5. Use the Volume Up and Volume Down keys on your Nexus 5 to select ""install zip" and next "install zip from sideload" and now you should have the following text on your device screen :
    ClockworkMod Recovery v6.0.4.3

    Sideload started ...
    Now send the package you want to apply
    to the device with "adb sideload <filename>" ...
  6. From your PC, execute the following command:
    adb devices
    and if you have the following output
    List of devices attached
     ???????????? no permissions
    then follow the commands to restart the adb server (here in the Troobleshooting part) or if you can not wait (with the root account) :
    # adb kill-server
    # adb start-server
    * daemon not running. starting it now on port 5037 *
    * daemon started successfully *
    check now if all works fine :
    # adb devices
    List of devices attached
    your_nexus_serial_number recovery
  7. From your PC, execute the following command:
    adb sideload
  8. The image will now install. It will installs both the kernel and the rootfs and now you should have the following text on your device screen :
    Restarting adbd...
    Finding update package...
    Opening update package...
    Installing update...

    Welcome to the LuneOS RootFS Updater

    Mounting system and userdata partitions...
    Copying the LuneOS rootfs tarball...
    Deploying LuneOS...
    Flashing kernel ...

  9. Once completed, reboot the Nexus 5 (In ClockworkMode, use the following entries in the menu: Go Back -> reboot system now -> Go back). (If ClockworkMode asks if you want to 'root device', answer no.)
  10. Your system should now boot directly into LuneOS

Helpful Tip

See something wrong on this page? Report it here.