Difference between revisions of "PinePhone Installation Instructions"

Jump to navigation Jump to search
(Made differences to the Pro more clear)
Line 1: Line 1:
This section has generic installation instructions. Please see the [[PinePhone Software Releases]] section for specific installation instructions for each distribution.
This section has generic installation instructions.  
 
For specific installation instructions for each distribution please see the software releases pages:
 
* for the '''PinePhone''': [[PinePhone Software Releases]]
* for the '''PinePhone Pro''': [[PinePhone Pro Software Releases]]


== Boot priority ==
== Boot priority ==
=== PinePhone Pro ===
For details regarding the boot priority on the PinePhone Pro see [[PinePhone Pro#Boot order]].
=== PinePhone ===


The PinePhone always boots from the microSD card first. It is therefore recommended to have a microSD card handy. It is '''not''' possible to lock themself out of the phone when the installation on the internal storage (the eMMC) fails, as a correctly flashed microSD card will always boot. Note: Booting from USB is not supported by the hardware, a live USB stick will not boot.
The PinePhone always boots from the microSD card first. It is therefore recommended to have a microSD card handy. It is '''not''' possible to lock themself out of the phone when the installation on the internal storage (the eMMC) fails, as a correctly flashed microSD card will always boot. Note: Booting from USB is not supported by the hardware, a live USB stick will not boot.
Line 12: Line 23:
To install an image to the microSD card:
To install an image to the microSD card:


# Download your chosen image from [[PinePhone Software Releases]]
# Download your chosen image from [[PinePhone Software Releases]] for the regular '''PinePhone''' and [[PinePhone Pro Software Releases]] for the '''PinePhone Pro'''
# Extract the compressed file
# Extract the compressed file
# Write the image to your microSD card, see below
# Write the image to your microSD card, see below
# Plug microSD card into phone (make sure to use the top slot. NOT the bottom one)
# Plug microSD card into phone (make sure to use the top slot, not the bottom slot)
# On the '''PinePhone Pro''': The eMMC might have to be disconnected to boot from the microSD card, see [[PinePhone Pro#Boot order]]
# Boot phone
# Boot phone


Line 22: Line 34:
=== Flashing the microSD ===
=== Flashing the microSD ===
==== Using dd ====
==== Using dd ====
Make sure to select the correct device using <code>lsblk</code>. Then run <code>dd</code> with the correct device:
Make sure to select the correct device using <code>lsblk</code>. Then run <code>dd</code> with the selected device:


  sudo dd if='''IMAGE.img''' of=/dev/'''[DEVICE]''' bs=1M status=progress conv=fsync
  sudo dd if='''IMAGE.img''' of=/dev/'''[DEVICE]''' bs=1M status=progress conv=fsync
{{Info|The image needs to be written to the whole device, not to partition 1. Make sure you're NOT selecting ''/dev/sda1'' or ''/dev/mmcblk0p1'' as target.}}


==== Using bmaptool ====
==== Using bmaptool ====
Line 39: Line 53:


The eMMC can be flashed by holding vol+ on startup to boot into USB Mass Storage mode.
The eMMC can be flashed by holding vol+ on startup to boot into USB Mass Storage mode.
The process of flashing an OS to the eMMC is identical to that of any other storage medium - e.g. a microSD card. You can use the <i>dd</i> command or a utility such as Etcher or Gnome Disks, etc.
The process of flashing an OS to the eMMC is identical to that of any other storage medium - e.g. a microSD card. You can use the <i>dd</i> command or a utility such as Etcher or Gnome Disks, etc.


=== Using JumpDrive ===
=== Using JumpDrive ===
{{Info|This only applies to the regular '''PinePhone''', not the '''PinePhone Pro'''.}}


[[File:jumpdrive.jpg|400px|thumb|right|Jumpdrive running on the PinePhone]]
[[File:jumpdrive.jpg|400px|thumb|right|Jumpdrive running on the PinePhone]]
Line 74: Line 91:
== Resize partition to fit disk space ==
== Resize partition to fit disk space ==


{{Hint|Many OSes already include a script, which is resizing the partition on first boot, where this step is not required.}}
{{Info|Many OSes already include a script, which is resizing the partition on first boot, where this step is not required.}}


Once you've flashed the OS to your microSD card or eMMC storage, you may also need to expand the partition to fill all the available space.
Once you've flashed the OS to your microSD card or eMMC storage, you may also need to expand the partition to fill all the available space.
Line 82: Line 99:
For microSD cards, insert the microSD card and resize the partitions through the computer. For eMMC, insert the phone cable and use Jumpdrive to access the eMMC directly, and resize the partition after flashing the image. To do the flashing you have two options:
For microSD cards, insert the microSD card and resize the partitions through the computer. For eMMC, insert the phone cable and use Jumpdrive to access the eMMC directly, and resize the partition after flashing the image. To do the flashing you have two options:


====Using Growpart ====
==== Using Growpart ====


Install <i>growpart</i> and run:
Install <i>growpart</i> and run:
Line 91: Line 108:
If you get any errors about missing or unknown commands, use <code>apt-cache search</code> to find and install the needed software. Also don't forget to use <code>sudo</code>.
If you get any errors about missing or unknown commands, use <code>apt-cache search</code> to find and install the needed software. Also don't forget to use <code>sudo</code>.


====Using Parted ====
==== Using Parted ====


Parted's interactive mode and resize work well together. Do this before you put your microSD card into the PinePhone for the first time for best results.
Parted's interactive mode and resize work well together. Do this before you put your microSD card into the PinePhone for the first time for best results.
Line 100: Line 117:
  sudo resize2fs /dev/'''<the_second_sd_card_PARTITION>'''
  sudo resize2fs /dev/'''<the_second_sd_card_PARTITION>'''


=== Resize from within PinePhone ===
=== Resize from within the PinePhone ===


eMMC: you would need to resize the partition on eMMC (flashed with the operating system) by booting another image from the microSD card: that way, the eMMC will be unmounted. It is '''not recommended''' to resize eMMC while booted from eMMC! Resizing a currently mounted partition can have weird results. If you booted from the microSD card, you can follow the above guidelines on how to resize from a computer.  
eMMC: you would need to resize the partition on eMMC (flashed with the operating system) by booting another image from the microSD card: that way, the eMMC will be unmounted. It is '''not recommended''' to resize eMMC while booted from eMMC! Resizing a currently mounted partition can have weird results. If you booted from the microSD card, you can follow the above guidelines on how to resize from a computer.