Skip to content

Mffff4/UmbrelPatch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ”Œ UmbrelOS External Storage Patch

โšก Enable external storage support on your UmbrelOS device with a single command

Bitbucket Repo

โœจ Features

  • ๐Ÿš€ Enables external storage detection
  • ๐Ÿ”“ Bypasses Umbrel Home device check
  • ๐Ÿ”„ Automatic system reboot after patching
  • โฑ๏ธ 5-second countdown with cancel option

๐Ÿš€ Quick Start

Copy and paste this command into your terminal:

curl -sSL https://bitbucket.org/mffff4/umbrelpatch/raw/main/patch.sh | sudo bash

๐Ÿ”ง What's Under the Hood

The patch modifies two critical system files:

  1. /opt/umbreld/source/modules/files/external-storage.ts

    // Before
    return await isUmbrelHome()
    
    // After
    return true
  2. /opt/umbreld/source/modules/is-umbrel-home.ts

    // Before
    return manufacturer === 'Umbrel, Inc.' && model === 'Umbrel Home'
    
    // After
    return true

๐Ÿ›ก๏ธ Safety First

  • โœ… Verifies if files are already patched
  • ๐Ÿ“ Provides clear status messages
  • โฎ๏ธ Allows cancellation during reboot countdown
  • ๐Ÿ” Requires sudo privileges

๐Ÿ“ Important Notes

  • ๐Ÿ”„ System automatically reboots after successful patching
  • โน๏ธ Press Ctrl+C to cancel reboot during countdown
  • โ†ฉ๏ธ Patch is reversible by restoring original files
  • โš ๏ธ Important: Reapply patch after system updates

๐Ÿšจ Troubleshooting

Issue Solution
Permission denied Run with sudo
Files not found Verify UmbrelOS installation
Patch not working Check file permissions
After update Re-run installation command

๐Ÿค Contributing

Feel free to open issues or submit pull requests!

๐Ÿ“œ License

MIT License - feel free to use and modify!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages