| bin | ||
| lib | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
JuJu
JuJu: the portable GNU/Linux distribution
Description
JuJu is a small and portable GNU/Linux distribution based on ArchLinux. It allows to have an isolated GNU/Linux environment inside the home directory without the need to have root privileges that is accessible via chroot and run on whatever Linux distribution.
JuJu only contains the package manager (called pacman and yaourt) in order to access to a wide range of packages from ArchLinux repositories.
The main advantage of using JuJu are:
- It gives an isolated environment in which you can install packages without affecting a production system.
- Access to a really wide range of packages even inside GNU/Linux systems that contains limited repositories (such as CentOS and RedHat).
- Install packages without the need to be root.
Quickstart
There are three different ways you can run JuJu:
- As normal user - Allow to make basic operations using proot:
$ juju
- As fakeroot - Allow to install/remove packages using proot:
$ juju -f
- As root - Allow to have fully root privileges inside JuJu environment using arch-chroot (you need to be root for executing this):
# juju -r
The first time you execute it, the script will download the JuJu image and place it to the default directory ~/.juju. You can change the default directory by changing the environment variable JUJU_HOME.
Installation
Just clone JuJu somewhere (for example in ~/juju):
$ git clone git://github.com/fsquillace/juju ~/juju
$ export PATH=~/juju/bin:$PATH
JuJu can only works on GNU/Linux OS with kernel version greater or equal 2.6.32 on 64 bit architecture (32 bit and arm will be available soon).
Advanced usage
You can build a new JuJu image from scratch by running the following command:
# juju -b
In this way the script will create a directory containing all the essentials files to make JuJu working properly (such as pacman, yaourt, arch-chroot and proot). Remember that the script to build the image must run in an ArchLinux OS with arch-install-scripts installed.
To install the image named juju-x86_64.tar.gz:
# juju -i juju-x86_64.tar.gz
Dependencies
JuJu comes with a very short list of dependencies in order to be installed in most of GNU/Linux distributions. The dependencies needed to be in the host OS are:
- bash
- wget or curl
- mkdir
- linux kernel 2.6.32+
Troubleshooting
- Q: Why do I get the error "Cannot find the gzip binary required for compressing man and info pages." when I try to install package with yaourt?
- A: JuJu comes with a very basic number of packages. In order to install packages using yaourt you may need to install the package groups base-devel that contains all the essential packages for compiling source code (such as gcc, make, patch, etc):
pacman -S base-devel
- Q: Why do I get the error: "FATAL: kernel too old"?
- A: This is because the executable from the precompiled package cannot always run if the kernel is old. In order to check if the executable can be compatible with the kernel of the host OS just use file command, for instance:
file ~/.juju/usr/bin/bash
ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs), for GNU/Linux 2.6.32, BuildID[sha1]=ec37e49e7188ff4030052783e61b859113e18ca6, stripped
From the output you can see what is the minimum recommended Linux kernel version.
License
Copyright (c) 2012-2014
This program is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
Author
Filippo Squillace feel.squally@gmail.com