Tutorial to install PostmarketOS on IdeaPad Duet 3 Chromebook

Few definitions first:

• PostmarketOS is a linux distribution made for Chromebook devices. It's the only image that supports Qualcomm Snapdragon 7 in the Lenovo IdeaPad Duet 3
• ChromeOS is an operating system made for Chromebook devices, made by Google. It's mainly linux based, with its numerous quirks
• Developer mode is a special mode for ChromeOS made to allow full control on the device

What we gonna do

We want to nuke the ChromeOS operating system and replace by a full linux system. We have to fight against all doors and locks and threats that Google left for us, so let's dive in. You don't need to have any user set up, the process below works from the "bootstrap" screen when you first power on the tablet.

Entering developer mode

First things first, you need to enter developer mode or everything else will fail. Doing so will erase the device's user data so make a backup first if you've already installed something on this device. The process is the following:

1. Detach the keyboard (to avoid doing something wrong ...)
2. Power off the device (you can apply this process even if the device is not installed)
3. Press Volume +, Volume - and Power at the same time and hold them for 10s.
4. Release Power button, the tablet will enter recovery screen (if not, power off and retry).
5. Once in recovery screen, use Volume +, Volume - to navigate and Power to confirm.
6. Go to Show debug info button and validate it
7. It opens a new page. Press both Volume +, Volume - at the same time and press Power. I don't remember for how long you need to press it, but it should say Developer mode enabled
8. Then select Boot from internal disk and press Power.
9. It'll boot to the main screen, but you'll now have an option labelled Activate debug features or something like this
10. Click the button. You can attach the keyboard now.
11. It'll tell you it need to reboot to activate the feature, let it reboot
12. Re-run Boot from internal disk and click again the debug button on the main interface. It'll ask you to set the root password.
13. Congratulation, you're now a fully featured developer.

Preparing disks

You'll need to download a PostmarketOS image first, for example from here. You ever select the edge or the stable release version (24.12 at time of writing), then the device (google-trogdor) then the linux frontend (I've chosen Plasma desktop here, since it's the best ;-)

Once the disk image is downloaded, check the checksum is correct (with sha256sum /path/to/downloaded/image/file.zip) and compare with the published checksum on the website. Don't worry here if you don't find the exact frontend you want, we'll bootstrap postmarketos from itself.

Flash the image to a USB drive (don't use a SD card reader, they are so slow). You can use your preferred method here (from plain old dd to Raspberry Pi Imager. The latter allows to flash using the compressed image, else you'll need to run xz --decompress /path/to/image.img.xz first. In the latter, you'll choose "No filter", "Custom image" and your USB drive (not mounted).

Once the disk is prepared, you'll need to resize it via these command (in a terminal):

$ sudo e2fsck /dev/sdX3
[...]
$ sudo resize2fs /dev/sdX3
[...]

Replace X with the drive letter (if unsure, use lsblk to find out). You need at least 8GB drive, a 16GB is even better.

Booting to console

On the device:

1. Start in recovery mode, and select Boot from internal image (yes, that one)
2. Press Ctrl + Alt + ⟳ to open the main console
3. Login as root with the password you've set before
4. Type what's written on the screen to disable rootfs verification
5. Then type: crossystem dev_boot_usb=1 dev_boot_altfw=1
6. Type sync
7. Type poweroff and wait until the device powers off (few sec)

Post install

You can now select the Boot from external drive in the menu, provided you've plugged your USB drive on the device. It should load PostmarketOS.

1. Login with user and 147147 for the credentials.
2. Start a console (in System categorie)
3. Type sudo apk add pmbootstrap (type 147147 for the password)
4. If it fails, you'll need to set up the WIFI or Ethernet connection (bottom right icon). I'm connected via a USB hub with Ethernet, so I didn't had to do anything
5. Type pmbootstrap init
6. Select default value for the 2 first prompts (press Enter)
7. Select either edge or the last "stable" version (like v24.12)
8. Type the first password 147147 (this isn't the password of the final user but the current user password)
9. Choose google as vendor (not qemu)
10. Choose trogdor as device codename
11. Choose the desired username
12. Select the default provided for wifi (Enter)
13. Select the user interface of your choice. I'm using plasma-desktop
14. Select default for systemd question and all next question until Locale
15. Change your locale to your choice
16. Choose the name of the device
17. Select default values for everything else until you're back to the prompt
18. Type pmbootstrap install --disk=/dev/mmcblk1
19. Type y for overwriting
20. Type 147147 for user password
21. Let it prepare installation
22. Type your final user password twice
23. Say y to Erase question
24. Let it finish installation
25. Type sync at the prompt
26. Type pmbootstrap shutdown and 147147 for the user password
27. Reboot and unplug USB drive.