Install LuneOS for Pinephone

From WebOS-Ports
Revision as of 11:19, 17 November 2020 by Tofe (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This guide will walk you through the process of taking the Pinephone 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


Template:Recovery install dd

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 Pinephone should still be connected to your PC via USB from the last step
  2. Your Pinephone 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 Pinephone 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 Pinephone (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.