2026-08-08 15:42:45 +02:00
|
|
|
# fp6-img
|
|
|
|
|
|
|
|
|
|
Flashable [postmarketOS](https://postmarketos.org/) images for the
|
|
|
|
|
**Fairphone 6**, built nightly from the
|
|
|
|
|
[Catcrafts milos-linux](https://forgejo.catcrafts.net/Catcrafts/milos-linux)
|
|
|
|
|
`combined-stable` kernel branch, with
|
|
|
|
|
[imsd](https://forgejo.catcrafts.net/Catcrafts/imsd) (userspace VoLTE)
|
|
|
|
|
preinstalled.
|
|
|
|
|
|
|
|
|
|
Maintained by [Jorijn van der Graaf](https://catcrafts.net/about)
|
|
|
|
|
(TheMightyCat) at [Catcrafts](https://catcrafts.net/).
|
|
|
|
|
|
|
|
|
|
## What works
|
|
|
|
|
|
|
|
|
|
Everything on the `combined-stable` branch: display, touch, wifi, cellular
|
|
|
|
|
data, NFC (reader), speaker audio, microphone, IMU, magnetometer, barometer,
|
|
|
|
|
ambient light/proximity — plus VoLTE calls (both directions) through imsd.
|
|
|
|
|
|
|
|
|
|
Verified on exactly one device / one carrier (KPN NL). Reports from other
|
|
|
|
|
carriers are very welcome.
|
|
|
|
|
|
|
|
|
|
## Flashing
|
|
|
|
|
|
2026-08-10 10:40:50 +02:00
|
|
|
Download `fp6-img.tar.xz` from the latest release and unlock the bootloader
|
|
|
|
|
([Fairphone's official process](https://support.fairphone.com/hc/en-us/articles/10492476238737)).
|
2026-08-09 01:25:20 +02:00
|
|
|
|
2026-08-09 03:33:33 +02:00
|
|
|
**Install**: with the phone in fastboot mode,
|
2026-08-10 10:40:50 +02:00
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
tar xf fp6-img.tar.xz
|
|
|
|
|
cd fp6-img
|
|
|
|
|
./install.sh
|
|
|
|
|
```
|
|
|
|
|
|
2026-08-13 23:04:02 +02:00
|
|
|
`install.sh` erases dtbo, flashes the rootfs, **RAM-boots** the kernel, writes the boot partition from
|
2026-08-10 16:22:20 +02:00
|
|
|
inside Linux where the bootloader's NV-wipe cannot see it, then reads the modem
|
|
|
|
|
NV back and reports the result. The bootloader never writes `boot`.
|
2026-08-09 01:29:17 +02:00
|
|
|
|
2026-08-08 15:42:45 +02:00
|
|
|
Default login: `user` / `147147` (same as official postmarketOS images —
|
|
|
|
|
change it). **Never re-lock the bootloader** with a custom image installed.
|
|
|
|
|
|
|
|
|
|
## VoLTE configuration
|
|
|
|
|
|
|
|
|
|
imsd is installed but needs your carrier's P-CSCF address:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
# /etc/imsd.env
|
|
|
|
|
PCSCF=<your carrier's P-CSCF IPv6 address>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Find it in a stock-firmware capture or your carrier's IMS documentation, then
|
2026-08-08 23:46:01 +02:00
|
|
|
`systemctl restart imsd` (the service is enabled at boot and waits for this
|
|
|
|
|
file to exist). See the
|
2026-08-08 15:42:45 +02:00
|
|
|
[imsd README](https://forgejo.catcrafts.net/Catcrafts/imsd) for the full
|
|
|
|
|
variable reference and carrier assumptions.
|
|
|
|
|
|
|
|
|
|
## How it builds
|
|
|
|
|
|
|
|
|
|
`build.sh` drives [pmbootstrap](https://gitlab.postmarketos.org/postmarketOS/pmbootstrap)
|
|
|
|
|
with the `aports/` overlay in this repository:
|
|
|
|
|
|
|
|
|
|
- `device/linux-postmarketos-qcom-milos` — the pmaports kernel aport,
|
2026-08-09 01:57:46 +02:00
|
|
|
repointed at `combined-stable` with the exact kernel config the development FP6 runs.
|
2026-08-08 15:42:45 +02:00
|
|
|
- `modem/imsd` — imsd, packaged from source. Its `provides=81voltd` keeps the
|
|
|
|
|
conflicting modem-firmware IMS helper off the image (two IMS stacks cannot
|
|
|
|
|
share one PDN).
|
|
|
|
|
- `main/postmarketos-config-nftables` — adds the `-imsd` subpackage accepting
|
|
|
|
|
imsd's IPsec-protected SIP ports on the IMS PDN (auto-installed alongside
|
2026-08-14 23:00:42 +02:00
|
|
|
imsd).
|
|
|
|
|
- `device/catcrafts-fp6-repo` — subscribes the installed system to the
|
|
|
|
|
[Catcrafts apk registry](https://forgejo.catcrafts.net/Catcrafts/-/packages)
|
|
|
|
|
(signing key + `/etc/apk/repositories` entry). CI publishes every built
|
|
|
|
|
package there, so `apk upgrade` delivers kernel/imsd/GNSS updates between
|
|
|
|
|
image releases.
|
