# Installing subuser

## System Requirements

> - Docker 1.3 or higher

> - Python >= 3

> - Git

> - X11 and the xauth utility (You almost certainly have this)

> - sudo (if you don’t want to become a member of the docker group)

## Installation: Common steps

1. Add yourself to the `sudo` group (Note: if you are a member of the `docker` group this is not needed.).

    $ sudo usermod -a -G sudo $USER

## Install from your distributions package manager

> - Arch linux AUR

> - Debian sid

> - Ubuntu

> - pipy

## Install with pip: Stable version

1. Install subuser from `pip3`:

       $ sudo pip3 install subuser

2. Add `~/.subuser/bin` to your path by adding the line `PATH=$HOME/.subuser/bin:$PATH` to the end of your `~/.bashrc` file.

3. Log out and then back in again.

4. Done!

## Install from git: Development version

1. Download the subuser repository:

       $ cd
       $ git clone https://github.com/subuser-security/subuser

2. Add `subuser/logic` and `~/.subuser/bin` to your path by adding the line `PATH=$HOME/subuser/logic:$HOME/.subuser/bin:$PATH` to the end of your `.bashrc` file.

3. Optional: Subuser can run in place. If you want to install the development version system wide you can do so with:

       sudo python3 setup.py install

Note

You will need to change the path to `subuser/logic` to refer to the location to which you downloaded subuser.

1. Log out and then back in again.

2. Done!

## Source

The subuser sourcecode is maintained on github. You can find release tarbals here.