~mil/sxmo-docs

sxmo-docs/INSTALLGUIDE.md -rw-r--r-- 3.8 KiB
47b7e2ebMaarten van Gompel described pinentry 10 days ago

#Sxmo: Simple X Mobile - Install Guide


Project Overview | Install Guide | User Guide | Contributing | Images | Demo Videos | Changelog


#Prebaked Images

The easiest way to get started using Sxmo is just to grab a prebaked image from pmOS's BPO build system. These images are generated on a weekly basis. These images under the hood are based on postmarketOS and are identical to what you'd get if you were to manually run pmbootstrap locally and chose Sxmo as your selected UI.

Install Steps:

  1. Download the latest release image from: pmOS's BPO Build system.
  2. Extract the image: unxz downloaded_image.xz
  3. Write the image to your SD card: dd if=downloaded_image.img of=/dev/mmcblk0 (Make sure to check if this is really your SD card device using lsblk!)
  4. Pop the SD card into your Pinephone and see the Userguide
  5. Please note, the default username/password combination is: user/147147
  6. Also note, the first time you boot up your SD card with Sxmo; pmOS will resize the root filesystem partition to the full size of the SD card. The time this takes is proportional to the size of the SD card, so if you use a large card expect this to take a few minutes - this is a one-time process and subsequent boots will be faster.
  7. After booting, make sure to check the User Guide for instructions on how to update as images are baked on a weekly basis so trail tip packages a bit.

#Alternative: Use a New or existing pmOS install

If you'd like to setup full-disk encryption or want to customize your install further then the prebaked images can provide, you can install the postmarketos-ui-sxmo package directly for an existing or new pmOS install instead.

Refer to the pmOS installation guide documentation and when using pmbootstrap make sure to select Sxmo as your UI.

#Moving an existing system from SD card to eMMC

If you have an existing system on SD card and want to move it to the internal eMMC (which is faster), then you can do so following these instructions:

  • Partition the eMMC (please double check this is really your eMMC): sudo fdisk /dev/mmcblk2
    • d (delete all partitions)
    • n (add new partition 1 for /boot, enter a size of at least 200M or 250M for more comfort)
    • n (add new partition 2 for /root, use all remaining size)
    • w (write changes to disk)
  • Create a boot partition (the label is essential): sudo mkfs.ext4 -L pmOS_boot /dev/mmcblk2p1
  • Create a root partition (the label is essential): sudo mkfs.ext4 -L pmOS_root /dev/mmcblk2p2
  • Create Temporary mountpoints and mount the eMMC partitions:
    • sudo mkdir /mnt/newboot /mnt/newroot
    • sudo mount /dev/mmcblk2p1 /mnt/newboot
    • sudo mount /dev/mmcblk2p2 /mnt/newroot
  • Copy stuff over (you may need to sudo apk add rsync first):
    • sudo rsync -avhP /boot/* /mnt/newboot/
    • sudo rsync -avhP /bin /etc /home /lib /lib64 /media /opt /root /sbin /share /srv /usr /var /mnt/newroot/
  • Create mountpoints on new root
    • cd /mnt/newroot && sudo mkdir boot proc run dev sys mnt
  • No need to edit the new /etc/fstab, pmos doesn't use it as it mounts by label