Installing subuser

System Requirements

  • Docker 1.3 or higher
  • Python >= 3
  • Git
  • X11 and the xauth utility (You almost certainly have this)

Installation: Common steps

  1. Add yourself to the docker group.

Warning

Being a member of the docker group is equivalent to having root access.

$ sudo usermod -a -G docker $USER

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.

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!