Project Overview | Install Guide | User Guide | System Guide | Contributing | Images | Demo Video
Documentation (postmarketOS Stable) | Documentation (postmarketOS edge) | Documentation (Development Version)
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:
unxz downloaded_image.xz
dd if=downloaded_image.img of=/dev/mmcblk0
(Make sure to check if this is really your SD card device using lsblk
!)user
with the lockscreen password set up during the installer. (If the installer wasn't used, the default password is 147147
).
user
.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:
sudo usermod -G audio,input,video,netdev,plugdev -a $SSH_USERNAME
(logout and login again after this step if you opted for the latter).user
as it doesn't have a purpose anymore.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.
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:
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)sudo mkfs.ext4 -L pmOS_boot /dev/mmcblk2p1
sudo mkfs.ext4 -L pmOS_root /dev/mmcblk2p2
sudo mkdir /mnt/newboot /mnt/newroot
sudo mount /dev/mmcblk2p1 /mnt/newboot
sudo mount /dev/mmcblk2p2 /mnt/newroot
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/
cd /mnt/newroot && sudo mkdir boot proc run dev sys mnt
/etc/fstab
, pmos doesn't use it as it mounts by labelcommit a455c4c129b6e961eab742826c9be66bf5892429 Author: Peter John Hartman <peterjohnhartman@gmail.com> Date: 2023-03-31T07:00:49-05:00 updates for 1.14