#Sxmo: Simple X Mobile - Install Guide

Project Overview | Install Guide | User Guide | System Guide | Contributing | Images | Demo Video

Documentation (postmarketOS Stable) | Documentation (postmarketOS edge) | Documentation (Development Version)

#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, for general use, login as user with the lockscreen password set up during the installer. (If the installer wasn't used, the default password is 147147).
    1. The ssh user for the installer is only intended for login over ssh, not for logging into a graphical session. To enable sxmo's ssh features, you can set up ssh for user.
    2. login with the ssh user setup during the installer
    3. enable ssh for graphical user (called user)
    4. install ssh key and disable ssh login with password
    5. delete the dedicated ssh user, as it doesn't have a purpose anymore.
  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

Alternative to step 5: Setting the ssh user from the installer as the main user instead

This is an alternative to step 5 in the above installation procedure. Instead of setting using user, you can use the user you configured for ssh for graphical login. Although this is not the recommended way by postmarketOS, it may be preferred by some users:

  1. Login with the ssh user setup during the installer
  2. Add the ssh user to the necessary groups using: sudo usermod -G audio,input,video,netdev,plugdev -a $SSH_USERNAME (logout and login again after this step if you opted for the latter).
  3. Install ssh key and disable ssh login with password
  4. Delete either the default user as it doesn't have a purpose anymore.
#Alternative: Use a New or existing pmOS install

If you'd like to customize your install further than the prebaked images can provide, you can install the postmarketos-ui-sxmo package directly.

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

About this wiki

commit 150f7c7bbc05873d773d6a7ee2e3faaee7c9681f
Author: Aleksey Ryndin <continue@to.any-key.press>
Date:   2023-06-02T10:11:45+00:00

Fix link to https://sr.ht/~mil/sxmo/">

Signed-off-by: Willow Barraco <contact@willowbarraco.fr>
Clone this wiki
https://git.sr.ht/~anjan/sxmo-docs (read-only)
git@git.sr.ht:~anjan/sxmo-docs (read/write)