Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Jamesits/menhera.sh
Start a RAM Linux system and free your system disk without physical access to your server.
https://github.com/Jamesits/menhera.sh
Last synced: 7 days ago
JSON representation
Start a RAM Linux system and free your system disk without physical access to your server.
- Host: GitHub
- URL: https://github.com/Jamesits/menhera.sh
- Owner: Jamesits
- License: mit
- Created: 2019-04-09T07:50:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T12:22:39.000Z (almost 2 years ago)
- Last Synced: 2024-11-01T05:02:13.124Z (12 days ago)
- Language: Shell
- Homepage: https://cursed.im/menhera
- Size: 58.6 KB
- Stars: 87
- Watchers: 5
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# menhera.sh
Start a RAM Linux system (Debian for now) without requiring physical access to your server.
With `menhera.sh` you can:
* format your system disk or create RAID
* install a new distro
* do important maintenance or backup with nobody writing to your root filesystem
* ...
with only SSH!
"menhera" is short for "mental healer".
## WARNING
I am not responsible for bricked devices, dead HDDs and SSDs, unreplied tickets, thermonuclear war, or you getting fired because your device is hacked to mine bitcoin. Please do some research if you have any concerns about this script before using it! YOU are choosing to run this script, and if you point the finger at me for messing up your device, I will laugh at you.
## Dependencies
* Linux kernel: overlayfs and tmpfs support
* systemd
* bash
* squashfs-tools
* curl or wget
* ~400MiB RAM in theory
## Usage
1. Save your work
1. Backup all your important files
1. Shutdown as many services and programs you can on the victim
1. If you use SSH to connect to the server, make sure you can log in directly as root using SSH with a password (You need to set a password for root!)
1. run the script, and follow the instructions
`menhera.sh` will try to download a new rootfs into the memory, replace the old rootfs and kill all processes accessing the old rootfs. The old rootfs will be mounted to `/mnt/oldroot`. An simplified example filesystem structure after running `menhera.sh` on my test VPS:
```
root@localhost:~# findmnt
TARGET SOURCE FSTYPE OPTIONS
/ overlay overlay rw,relatime,lowerdir=/tmp/menhera/newrootro,upperdir=/tmp/menhera/newrootrw,workdir=/tmp/menhera/overlayfs_workdir
├─/sys sysfs sysfs rw,nosuid,nodev,noexec,relatime
├─/proc proc proc rw,nosuid,nodev,noexec,relatime
├─/dev udev devtmpfs rw,nosuid,relatime,size=1014856k,nr_inodes=253714,mode=755
├─/run tmpfs tmpfs rw,nosuid,noexec,relatime,size=205236k,mode=755
├─/mnt/oldroot /dev/md0p1 ext4 rw,relatime,discard,data=ordered
└─/tmp tmpfs tmpfs rw,relatime
└─/tmp/menhera tmpfs tmpfs rw,relatime
└─/tmp/menhera/newrootro /dev/loop0 squashfs ro,relatime
```
## Thanks
* This project is inspired by [marcan/takeover.sh](https://github.com/marcan/takeover.sh)
* The major code came from [a maintenance writeup on my blog](https://blog.swineson.me/zh/debian-9-csm-online-convert-root-partition-to-raid/) (in Simp. Chinese)
* [xTom.com](https://xtom.com/) donated a VPS for my testing