Skip to content

Releases

Nura (beta) · 2026-11-20 (latest)

Choose a tag to compare

@github-actions github-actions released this 20 Nov 11:27

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, or xz -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

Choose a tag to compare

@github-actions github-actions released this 20 Nov 11:26

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, or xz -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)

Choose a tag to compare

@github-actions github-actions released this 19 Nov 23: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, or xz -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

Choose a tag to compare

@github-actions github-actions released this 19 Nov 23:00

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, or xz -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)

Choose a tag to compare

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.img from 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.img into the GPT partition system and the kernel into los_boot.
  • Erases los_metadata and los_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

  1. TWRP 3.3.0-0: back up (see above) and copy the backup to a computer.
  2. sha256sum -c the zip against the .sha256 file.
  3. Copy the zip to the phone and install it in TWRP; it must finish without an error.
  4. 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

Pre-release

Choose a tag to compare

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.img from 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.img into the GPT partition system and the kernel into los_boot.
  • Erases los_metadata and los_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

  1. TWRP 3.3.0-0: back up (see above) and copy the backup to a computer.
  2. sha256sum -c the zip against the .sha256 file.
  3. Copy the zip to the phone and install it in TWRP; it must finish without an error.
  4. 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

Choose a tag to compare

@github-actions github-actions released this 16 Nov 00:55

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, or xz -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

Choose a tag to compare

@github-actions github-actions released this 15 Nov 23:53

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, or xz -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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 17:51

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, or xz -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)

Choose a tag to compare

@github-actions github-actions released this 09 Nov 17:55

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)

  1. TWRP: back up Boot, System, Vendor, Data and EFS, and copy the backup to a computer.
  2. 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.
  3. Install this zip (optionally a GApps package for Android 15 / arm64 afterwards).
  4. 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.