Chroot helper utility for all Linux distributions
Switch branches/tags
Clone or download
Latest commit ab40dab Sep 18, 2018

README.md

Groot

Groot is a tiny utility for chrooting into an installed Linux system. It is similar to the arch-chroot command available on Arch Linux, and is based on the same script. It can be used on any Linux distribution.

Chroot Basics

A chroot session changes the effective root directory to a specified path where another Linux system is installed. Applications running inside the chroot will only affect the chrooted system and cannot access or modify files outside the chroot jail.

This is useful for maintenance activities. You can add/remove software and run commands for updating the chrooted system. You can fix boot issues, and execute GUI applications without any worry of the applications affecting your current system.

Chroot requires root access. The current system (host) and the chrooted system (guest) must have the same architecture (i686, x86_64, etc). The host kernel is shared with guest system. Kernel modules required by the guest must be loaded on the host.

Usage

To chroot into a system, open a terminal window, cd to path where root filesystem is mounted and run the groot command.

cd /media/usbdrive
sudo groot

This will mount /dev, /run, /sys and other system directories; and chroot to the current directory.

You can also specify root path as an optional argument.

sudo groot /mnt/usbdrive

Type exit when you are done, to exit the session cleanly. This is important. If you don’t exit the session properly, the system subdirectories will remain mounted, and you may have to reboot the system.

Internet Sharing

Internet connection sharing is enabled by default. You can run commands that access the internet. Use option --no-internet if internet sharing is not required.

Display Sharing

Display sharing is enabled by default. You can run GUI applications that are installed on chrooted system. Use option --no-display if display sharing is not required.

Features

  • Automatic mounting and unmounting of /dev, /run, /proc, /sys and other system directories
  • Enables internet sharing to allow applications to connect to internet from chroot session
  • Enables display sharing to allow GUI applications to run from chroot session

Planned features:

  • Repairing boot issues on BIOS and EFI systems
  • Re-install GRUB, rebuild initramfs, update grub menu, etc

Installation

Binary installers are available on the Releases page.

You can download and install the latest release of groot on any Linux distribution, using the following one-line commands:

# 64-bit
cd /tmp && curl -s -L https://github.com/teejee2008/groot/releases/latest | egrep -o 'teejee2008/groot/releases/download/.*/groot-v[0-9.]*-amd64.run' | wget --base=http://github.com/ -i - -O groot-latest-amd64.run && sudo chmod a+x ./groot-latest-amd64.run && sudo ./groot-latest-amd64.run
# 32-bit
cd /tmp && curl -s -L https://github.com/teejee2008/groot/releases/latest | egrep -o 'teejee2008/groot/releases/download/.*/groot-v[0-9.]*-i386.run' | wget --base=http://github.com/ -i - -O groot-latest-i386.run && sudo chmod a+x ./groot-latest-i386.run && sudo ./groot-latest-i386.run

Donate

PayPal ~ If you find this application useful and wish to say thanks, you can buy me a coffee by making a one-time donation with Paypal.

Patreon ~ You can also sign up as a sponsor on Patreon.com. As a patron you will get access to beta releases of new applications that I'm working on. You will also get news and updates about new features that are not published elsewhere.

Bitcoin ~ You can send bitcoins at this address or by scanning the QR code below:

1Js5vfgmwKew4byF9unWacwAjBQVvZ3Fev