JuNest Linux Logo

The lightweight Arch Linux based distro that runs upon any Linux distros without root access.


The basic way to run JuNest is via the Proot as the backend program:

To know more about the JuNest execution modes depending on the backend program used, see the Usage section below.

After running JuNest

If the JuNest image has not been downloaded yet, the script will download the image from the repository and will place it to the default directory ~/.junest. You can change the default directory by changing the environment variable JUNEST_HOME.

If you are new on Arch Linux and you are not familiar with pacman package manager visit the pacman rosetta page.



JuNest comes with a very short list of dependencies in order to be installed in most of GNU/Linux distributions. Before installing JuNest be sure that all dependencies are properly installed in your system:

The minimum recommended Linux kernel of the host OS is 2.6.32 on x86 (32-bit and 64 bit) and ARM architectures. It is still possible to run JuNest on lower 2.6.x host OS kernels but errors may appear, and some applications may crash. For further information, read the Troubleshooting section below.

Just clone the JuNest repo somewhere (for example in ~/.local/share/junest):

git clone git://github.com/fsquillace/junest ~/.local/share/junest
export PATH=~/.local/share/junest/bin:$PATH

Installation using AUR (Arch Linux only)

If you are using an Arch Linux system you can, alternatively, install JuNest from the AUR repository:

yaourt -S junest-git
export PATH=/opt/junest/bin:$PATH

Method two

Alternatively, another installation method would be to directly download the JuNest image and place it to the default directory ~/.junest:

ARCH=<one of "x86_64", "x86", "arm">
mkdir ~/.junest
curl https://s3-eu-west-1.amazonaws.com/junest-repo/junest/junest-${ARCH}.tar.gz | tar -xz -C ~/.junest
export PATH=~/.junest/opt/junest/bin:$PATH

Direct downloads

JuNest images for each architecture.