Skip to content

Zenlua/Overlayfs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

585 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OverlayFS RW

Build module Latest Release

An Android module designed to mount OverlayFS with Read/Write (RW) permissions. This is an optimized and essential solution for devices utilizing the erofs partition format.

πŸ“Œ Quick Links

  • πŸš€ Update: Release | Changelog
  • ⚑ Requirements: Flash Magisk, KernelSU (KSU), or a similar manager app to use.
  • πŸ’‘ Recommendation: If you are currently using erofs partitions, you should highly consider using this module.

πŸ›  Version Comparison

1. Basic Version

  • Root Hiding: There is no built-in root hiding feature.
  • Switching: You can manually switch to (RO) to hide root.
  • Mount Mechanism: Supports Mount Overlay only; Mount Bind is not available.
  • Configuration: It can be edited directly at the following path:
    /data/adb/modules/overlayfs
    
  • Storage Capacity: Dynamically scales in terms of memory available on your /data partition.

2. Hidden Root Version

  • Root Hiding: Features a built-in system hidden root capability.
  • Default Mode: The default setting is configured to Mount Overlay with a fixed 4GB storage size.
  • Mount Bind Mode: The total actual file size is included plus 5GB of free space. Mount bind mode is only enabled when:
    • Mount overlay mode is not working properly on the device.
    • To manually enable mount bind, create a file at the following path: /data/adb/overlayfs/bind Β©
  • Custom RW Partitions: Modify the list of partitions that are rw in: /data/adb/overlayfs/partition.txt Β©
  • Add Prop: Add custom properties configuration at: /data/adb/overlayfs/system.prop
  • Independence: It operates completely independently and does not require installing Meta Module (with KSU).

⚠️ Note: All features marked with the © symbol require flashing the module.zip file to function properly.

πŸš‘ Troubleshooting & Recovery

If you encounter errors (such as a bootloop or freeze), you can mount overlayfs.img to edit or delete the problematic files directly within TWRP or OrangeFox Recovery:

  1. In the terminal screen of your recovery mode, type and execute the command:
    /data/adb/overlayfs/mount.sh
  2. After typing the command, the overlay directory will appear at:
    /data/adb/overlayfs/overlay
    
    where you can edit the files.

About

Overlayfs RW allows editor system, product, vendor, system_ext files

Topics

Resources

Stars

Watchers

Forks

Releases

Sponsor this project

Used by

Contributors

Languages