關於postmarketOS系統的介紹請看這篇。
這篇文章是用pmbootstrap安裝postmarketOS的教學，只要你的機型有在官方支援列表，都能夠按照此步驟操作，將postmarketOS安裝至裝置上。
pmbootstrap是postmarketOS官方提供的工具，可以從無到有建立postmarketOS系統，套件內容可完全自訂。
除了建立安裝檔以外，pmbootstrap亦能進行新機移植工作。
本文示範手動在電腦上建立postmarketOS安裝檔再刷入手機。我的電腦是Ubuntu LTS，手機是小米Pocophone F1，安裝最新版原廠韌體，已解鎖Bootloader，安裝TWRP作為Recovery。
1. 安裝pmbootstrap#
參考pmbootstrap - postmarketOS Wiki指示
由於需要建立QEMU虛擬機，pmbootstrap僅支援x86_64架構的電腦。
在Linux用套件管理員安裝pmboostrap。
# Alpine Linux, postmarketOS
apk add pmbootstrap
# Arch Linux
pacman -S pmbootstrap
# Debian
apt install pmbootstrap
# Fedora
dnf install pmbootstrap
如果你的發行版沒有pmbootstrap套件，或者套件太舊，請改用Git方式安裝。
cd ~
git clone --depth=1 https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git
mkdir -p ~/.local/bin
ln -s "$PWD/pmbootstrap/pmbootstrap.py" ~/.local/bin/pmbootstrap
echo 'PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
2. 選擇機型並設定選項#
- 執行pmbootstrap init指令
pmbootstrap init
- 並按照指示填入。在初始化時會從Gitlab上下載最新版的機型設定檔。
#按Enter使用預設工作目錄 (~/.local/var/pmbootstrap)
Work path: Enter
#更新頻道選擇edge，或者填入寫有Recommended for best stability的穩定版。
Channel: edge
#選擇手機廠牌
Vendor: xiaomi
#選擇手機的裝置代號
Device codename: beryllium
#建立pmOS的使用者帳戶
Username: User
#選擇桌面環境，XFCE4(x11)適合沒有硬體加速的裝置；Phosh(Wayland，需要硬體加速)適合當手機介面。在開機後可以再另外安裝其他桌面環境。
User Interface: phosh
#剩下全部Enter
- 這就是每次建立對應機型的安裝檔要先做的工作，你必須告訴pmbootstrap你的postmarketOS應該長什麼樣子，才能開始建立安裝檔案。
3. 選擇安裝postmarketOS到手機的方法#
如果是Android手機，請確保在刷機之前安裝原廠最新版韌體，並解鎖Bootloader。
這個步驟就要建立安裝檔案了，主要有3種安裝postmarketOS的方法：
- 安裝至SD卡 (不會影響到原有手機系統，不推薦)
- 用fastboot刷入 (需清除資料，推薦)
- 用刷機包刷入 (需清除資料，太耗時不推薦)
除此之外還有一些比較奇怪的安裝方法，列在後面。
安裝至SD卡#
這個方法不會修改手機的資料，可以做雙系統，但是開機需要靠電腦下指令才能進入postmarketOS。注意有些手機可能不支援從fastboot以boot.img開機。
- SD卡插到電腦，用指令
lsblk確定SD卡的裝置代號，以及掛載點：
sdb 8:16 1 29.7G 0 disk /media/ivon/E8D8-4246
- 先取消掛載
umount /media/ivon/E8D8-4246
- 然後再開始安裝
pmbootstrap install --sdcard=/dev/sdb
pmbootstrap會自動格式化SD卡，並將系統安裝進去。過程中會要求建立使用者密碼，並會再確認是否要將SD卡格式化。
接著把SD卡裝到手機，讓手機進入fastboot模式，接到電腦，輸入指令開機:
pmbootstrap flasher boot
用fastboot刷入#
這個方法將清除手機所有的資料。
- 建立安裝檔
pmbootstrap install
2.手機進入fastboot模式，接到電腦刷入：
pmbootstrap flasher flash_rootfs
#如果刷入的分區容量太小，加上--partition參數，改刷入到其他分區:
pmbootstrap flasher flash_rootfs --partition userdata
- 再刷入kernel到boot分區，重開機：
pmbootstrap flasher flash_kernel
fastboot reboot
用刷機包安裝#
這個方法將清除手機所有的資料，可sideload或者傳輸刷機包到手機上再用TWRP安裝。不過建立刷機包很耗時。
- 建立刷機包，大約5分鐘。
pmbootstrap install --android-recovery-zip
#如果要安裝到其他較大的分區，可以加上--partition的選項
pmbootstrap install --android-recovery-zip --recovery-install-partition=data
手機接上電腦，重開機進入TWRP。從電腦的工作目錄找到建立的pmos-*.zip刷機包，例如我的檔案是在
~/.local/var/pmbootstrap/chroot_buildroot_aarch64/var/lib/postmarketos-android-recovery-installer。將檔案傳到手機，用TWRP安裝，之後重新開機。
將電腦上的pmbootstrap關閉：
pmbootstrap shutdown
其他刷入方法#
4. postmarketOS後續安裝優化#
就算開機無法進入桌面，手機用USB線連著電腦的情況下，也能用SSH連線到手機：
#這個IP是固定的，只需將「@」前面改成你的使用者帳號
ssh [email protected]
假設你的裝置順利進入postmarketOS桌面環境，並且GPU加速、觸控、網路、音效都正常的話，接下來請參考這篇：postmarketOS使用技巧了解postmarketOS的設定眉角，以及如何將postmarketOS當作手機系統用。