Universal Chroot environment that can be deployed to most Linux distributions, enabling the creation of portable boxes transferable among different hosts.
- Start a box
- Stop a box
- Create a box
- Delete a box
- Duplicate a box
- Enter a box
- List boxes
- List filesystems
- Upsize a box
- Mount of custom directories
- Enter the box directly to a specified shell
- Easily customizable source code
- Full Linux, Android, and Chromebook compatibility
Basically, Pandoras requires Bash to run itself, while boxes can be created to run different shells like Sh or Bash.
Keep in mind that the availability and functionality of Bash may vary based on the specific device, Android version, or Chromebook model you are using.
To get Bash, Android users can install an app such as Termux. Chromebook's users can use Bash after the activation of the Developer Mode.
System users without the sudo command, must log in as root instead.
cd
git clone git@github.com:estebanways/pandoras.git
sudo chown -R root:root pandoras/
sudo mv pandoras /var
This is going to create the directories:
/var/pandoras
: Your Pandoras main directory.
/var/pandoras/env
: The env directory.
/var/pandoras/images
: The images directory and also the filesystems configuration directory.
/var/pandoras/process
: The process directory.
/var/pandoras/environment
: The chroot environment directory that will be mounted.
If you want to have a main directory instead of /var/pandoras make sure you edit the Pandoras scripts to your directory.
/var/pandoras can be anything, depending on where you do want to put your boxes images (the directory or partition that have enough free space). For Chrome OS it's best on /home/chronos directory and on Android it's best on /storage or /data directory.
#!/bin/env bash
export dir=#your custom directory, or just leave it if you want to use /var/pandoras
For Debian based distributions, run:
sudo apt-get update
sudo apt-get install debootstrap
For RHEL, do run:
sudo yum install debootstrap
# Or
sudo dnf install debootstrap
If you are using OpenSUSE:
sudo zypper install debootstrap
For Arch based distributions:
sudo pacman -S debootstrap
For other distros (custom debootstrap build):
Don't do this if you can install debootstrap with package manager.
sudo su - # As root user
cd /tmp # Navigate to your tmp directory, or Download directory (any directory for trash data)
wget https://github.com/raw/rafi16jan/universal-chroot/master/debootstrap/debootstrap.sh
sh debootstrap.sh
tar xvf debootstrap.tar.gz
mkdir /usr/share/debootstrap
cp debootstrap-*/debootstrap /usr/bin/ # Or can be your another favorite bin directory
cp debootstrap-*/functions /usr/share/debootstrap/
cp -r debootstrap-*/scripts /usr/share/debootstrap/
wget https://github.com/raw/rafi16jan/universal-chroot/master/debootstrap/pkgdetails -O /usr/share/debootstrap/pkgdetails
wget https://github.com/raw/rafi16jan/universal-chroot/master/debootstrap/ar -O /usr/local/bin/ar # Your favorite bin directory
chmod a+x /usr/share/debootstrap/pkgdetails
chmod a+x /usr/bin/ar
exit # exit the root user
Navigate to your favorite bin directory.
cd /usr/bin
Make a soft link (shortcut) of your scripts file.
sudo ln -s /var/pandoras/pandoras.sh ./pandoras # Remember /var/pandoras can be different
ls -l pandoras
Symbolic links (symlinks) in Linux always appear with the permissions lrwxrwxrwx, which means they are read, write, and execute for all users, but it doesn't represent the actual permissions of the target file or directory. The permissions of the symlink itself are not relevant in terms of access control.
Create your first box image.
sudo pandoras --create-box
Done! Now, to start your box just execute sudo pandoras --start-box
.
For more command options and shortcuts execute pandoras --help
.
You can modify the default mount points in the script includes/create_box.sh before creating a new Pandoras box. These changes will remain until the next modification of the file.
For example, to add a mount point for /dev/pts:
sudo nano /var/pandoras/includes/create_box.sh
Uncomment the next line:
#echo "/dev/pts $dir/environment/dev/pts" >> "$dir/images/$chroot.filesystems.mnt"
Save changes and then create your new box.
The mount points will be stored in a brand-new Pandoras box file .filesystems.mnt.
You can also modify the mount points in the Pandoras Box file .filesystems.mnt before starting the box. These changes will remain until the next modification of the file.
For example, add a new mount point like this:
/home/my_user/tmp /var/pandoras/environment/mnt
To enter your box using Sh instead of Bash (Pandoras default) as shell, modify the script includes/enter_box.sh like this:
# Enter the chroot using the shell defined in the main system
#chroot $dir/environment /bin/su -
# Enter the chroot using sh as shell
chroot $dir/environment /bin/sh
To be able to upsize chroots with Pandoras, install qemu-utils. For example:
sudo apt-get install qemu-utils
- @estebanways - Maintainer
This project was originally developed by rafi16jan in Sh. The initial version of this codebase can be found at rafi16jan/universal-chroot.