Repository navigation
Releases
Nura (beta) · 2026-11-20 (latest)
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
This is a copy of Nura (beta) · 2026-11-20 (nura-20261120), the newest published build.
Nura (beta) · 2026-11-20
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
Nura (beta) · 2026-11-19 (2)
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
Nura (beta) · 2026-11-19
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
LineageOS 24 (alpha) · 2026-11-20 (latest)
LineageOS 24 (Android 17) on mainline Linux 7.3.1 for the ZTE Axon 7 (A2017G): an alpha / developer preview, flashable in TWRP into the LineageOS slot of the multi-boot setup. Not for daily use: no calls, no mobile data, no camera, no suspend.
Alpha. Back up first. Make a TWRP backup (Boot, EFS, Modem, and anything else you want to keep) and copy it to a computer before installing. Any failure while flashing can brick the phone.
Requirements (read first)
- A2017G only (tested on 4 GB / 64 GB).
- Unlocked bootloader, TWRP 3.3.0-0 (
twrp-3.3.0-0-ailsa_ii.imgfrom https://dl.twrp.me/ailsa_ii/; the tested version). - The project's multi-boot setup (boot menu with iOS / Nura / LineageOS), including the partition step
axon7-tripleboot-gpt, which creates the LineageOS partitions: DEV-MULTIBOOT.md. This build does not install on its own. - The vendor partition of a ROM installed before (LineageOS 16–18.1, or this project's LineageOS 22.2) must still be in place: the GPU firmware is read from it. Do not wipe Vendor in TWRP.
What the zip changes
- Writes
super.imginto the GPT partitionsystemand the kernel intolos_boot. - Erases
los_metadataandlos_data: all LineageOS data in the multi-boot slot is lost, and a LineageOS 22.2 installed in that slot is replaced. - Does not touch
boot,misc, iOS, Nura,persist, the modem/EFS partitions or the bootloader.
No proprietary firmware is in the zip. LineageOS 24 loads the modem, DSP, GPU and Wi-Fi board firmware straight from the phone's own partitions, read-only, at every start (modem, and a530_zap from vendor). This is new in this release and still being tested.
Install
- TWRP 3.3.0-0: back up (see above) and copy the backup to a computer.
sha256sum -cthe zip against the.sha256file.- Copy the zip to the phone and install it in TWRP; it must finish without an error.
- Reboot and choose LineageOS in the boot menu. The first start takes a few minutes.
State
Tested on the phone: boots to the setup wizard and home screen; display 1440x2560 with brightness slider; touchscreen and the three touch keys; Wi-Fi scans and connects; Bluetooth turns on; speaker playback and microphone recording; accelerometer, gyroscope, magnetometer, light and proximity sensors; battery level and charging; temperature sensors; hardware watchdog; plain reboot returns to LineageOS; modem firmware boots and goes online, GNSS service starts; software codecs (Codec2). A 20-minute stress soak ran without crashes, reboots or kernel warnings.
Built, not tested yet: headphone playback (jack detection is wired up), vibrator, GPS fix.
Not working: calls, SMS, mobile data (no radio HAL yet; SIM not detected so far), camera, fingerprint (TrustZone-owned), NFC, suspend/deep sleep (short battery life), encryption.
Scrolling is usable but not perfectly smooth (about 13 % janky frames in a scroll benchmark).
Userdebug build, SELinux permissive (policy in progress). Graphics: Mesa freedreno (Adreno 530, GLES 3.1), drm_hwcomposer, minigbm.
Problems
Enable USB debugging (Settings → About phone → tap Build number 7 times; System → Developer options) and send adb logcat -b all -d and adb shell dmesg. After a crash or restart, go to TWRP right away (Power + Volume Up about 10 s) and send adb pull /sys/fs/pstore/. Say which build (date) you run.
Source
Kernel (GPLv2): Linux 7.3.1 with the Axon 7 patches at https://github.com/devilAPI/linux/tree/zte-axon7, plus the Android kernel patches, Mesa patches and device tree on the lineageos-24-mainline branch of https://github.com/devilAPI/zte-axon7 (folder lineageos-24-mainline/).
Not affiliated with ZTE or LineageOS. Flash at your own risk.
This is a copy of LineageOS 24 (alpha) · 2026-11-20 (lineageos-24-20261120), the newest published build.
LineageOS 24 (alpha) · 2026-11-20
LineageOS 24 (Android 17) on mainline Linux 7.3.1 for the ZTE Axon 7 (A2017G): an alpha / developer preview, flashable in TWRP into the LineageOS slot of the multi-boot setup. Not for daily use: no calls, no mobile data, no camera, no suspend.
Alpha. Back up first. Make a TWRP backup (Boot, EFS, Modem, and anything else you want to keep) and copy it to a computer before installing. Any failure while flashing can brick the phone.
Requirements (read first)
- A2017G only (tested on 4 GB / 64 GB).
- Unlocked bootloader, TWRP 3.3.0-0 (
twrp-3.3.0-0-ailsa_ii.imgfrom https://dl.twrp.me/ailsa_ii/; the tested version). - The project's multi-boot setup (boot menu with iOS / Nura / LineageOS), including the partition step
axon7-tripleboot-gpt, which creates the LineageOS partitions: DEV-MULTIBOOT.md. This build does not install on its own. - The vendor partition of a ROM installed before (LineageOS 16–18.1, or this project's LineageOS 22.2) must still be in place: the GPU firmware is read from it. Do not wipe Vendor in TWRP.
What the zip changes
- Writes
super.imginto the GPT partitionsystemand the kernel intolos_boot. - Erases
los_metadataandlos_data: all LineageOS data in the multi-boot slot is lost, and a LineageOS 22.2 installed in that slot is replaced. - Does not touch
boot,misc, iOS, Nura,persist, the modem/EFS partitions or the bootloader.
No proprietary firmware is in the zip. LineageOS 24 loads the modem, DSP, GPU and Wi-Fi board firmware straight from the phone's own partitions, read-only, at every start (modem, and a530_zap from vendor). This is new in this release and still being tested.
Install
- TWRP 3.3.0-0: back up (see above) and copy the backup to a computer.
sha256sum -cthe zip against the.sha256file.- Copy the zip to the phone and install it in TWRP; it must finish without an error.
- Reboot and choose LineageOS in the boot menu. The first start takes a few minutes.
State
Tested on the phone: boots to the setup wizard and home screen; display 1440x2560 with brightness slider; touchscreen and the three touch keys; Wi-Fi scans and connects; Bluetooth turns on; speaker playback and microphone recording; accelerometer, gyroscope, magnetometer, light and proximity sensors; battery level and charging; temperature sensors; hardware watchdog; plain reboot returns to LineageOS; modem firmware boots and goes online, GNSS service starts; software codecs (Codec2). A 20-minute stress soak ran without crashes, reboots or kernel warnings.
Built, not tested yet: headphone playback (jack detection is wired up), vibrator, GPS fix.
Not working: calls, SMS, mobile data (no radio HAL yet; SIM not detected so far), camera, fingerprint (TrustZone-owned), NFC, suspend/deep sleep (short battery life), encryption.
Scrolling is usable but not perfectly smooth (about 13 % janky frames in a scroll benchmark).
Userdebug build, SELinux permissive (policy in progress). Graphics: Mesa freedreno (Adreno 530, GLES 3.1), drm_hwcomposer, minigbm.
Problems
Enable USB debugging (Settings → About phone → tap Build number 7 times; System → Developer options) and send adb logcat -b all -d and adb shell dmesg. After a crash or restart, go to TWRP right away (Power + Volume Up about 10 s) and send adb pull /sys/fs/pstore/. Say which build (date) you run.
Source
Kernel (GPLv2): Linux 7.3.1 with the Axon 7 patches at https://github.com/devilAPI/linux/tree/zte-axon7, plus the Android kernel patches, Mesa patches and device tree on the lineageos-24-mainline branch of https://github.com/devilAPI/zte-axon7 (folder lineageos-24-mainline/).
Not affiliated with ZTE or LineageOS. Flash at your own risk.
Nura (beta) · 2026-11-16
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
Nura (beta) · 2026-11-14
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
Nura (beta) · 2026-11-09
Nura (beta): Linux (postmarketOS, mainline Linux 7.3) for the ZTE Axon 7 (A2017G). It runs from the microSD card; internal storage is not touched.
Files
nura-axon7-DATE-sdcard.img.xz: write it to the microSD card (balenaEtcher, orxz -dc … | dd). The card is erased.nura-axon7-DATE-boot.img: flash it in TWRP: Install → Install Image → Boot. Back up your Boot partition first (that is your way back to Android).SHA256SUMS-DATE: checksums (sha256sum -c).
First start
Nura contains no Qualcomm/ZTE firmware: at the first start it copies the firmware from your phone's own partitions and restarts once. Then log in as user, password nura, and change the password right away with passwd.
Full guide: https://github.com/devilAPI/zte-axon7/blob/main/INSTALL-NURA.md. What works and what doesn't: see the XDA thread.
Kernel source (GPLv2): https://github.com/devilAPI/linux/tree/zte-axon7. Not affiliated with ZTE or postmarketOS. Flash at your own risk.
LineageOS 22.2 · 2026-11-09 (latest)
LineageOS 22.2 (Android 15) for the ZTE Axon 7 (A2017G): an unofficial LineageOS 22.2 release, flashable in TWRP. This is not the multi-boot setup: it replaces the Android on the phone.
Requirements (read first)
- A2017G only (tested on 4 GB / 64 GB).
- Unlocked bootloader, TWRP 3.3.0 or newer (3.7.0_9-0 recommended).
- The Oreo "universal" bootstack (TrustZone
TZ.BF.4.0.1-00353), the same as LineageOS 15.1–18.1 needed. The installer checks it and stops if it is missing. - The community vendor partition (512 MiB after system), as for LineageOS 16–18.1. If you came from one of those, you have it. If not, create it with Oki's PARTY tool (TWRP zip, https://xdaforums.com/t/tool-treble-party-v0-5-vendor-partition-manager-2018-08-31.3831517/) first. The original ZTE layout without a vendor partition is not supported.
- With the vendor partition, official ZTE firmware can't be flashed until it is removed again (PARTY tool). Any failure while flashing or repartitioning can brick the phone.
Install (clean)
- TWRP: back up Boot, System, Vendor, Data and EFS, and copy the backup to a computer.
- Wipe → Advanced: Dalvik, Cache, System, Vendor, Data. Coming from LineageOS 18.1 or older (footer encryption), also Format Data (type
yes): Android 15 uses file-based encryption. - Install this zip (optionally a GApps package for Android 15 / arm64 afterwards).
- Reboot → System. The first start takes a few minutes.
sha256sum -c the zip against the .sha256 file before flashing.
State
SELinux is enforcing.
See the XDA thread for what works and what does not. The kernel (GPLv2) is at https://github.com/devilAPI/android_kernel_zte_msm8996/tree/axon7 and the patches are in this repository (lineageos/).
Not affiliated with ZTE or LineageOS. Flash at your own risk.
This is a copy of LineageOS 22.2 · 2026-11-09 (lineageos-22.2-20261109), the newest published build.