NAME

       subuser - install, administer, and run desktop applications with Docker.

SYNOPSIS

       subuser [SUBCOMMAND] [SUBCOMMAND ARGS]

DESCRIPTION

       subuser  allows you to install and administer desktop applications contained using Docker. This is useful
       if you need to provide portability across Linux distributions or  hightened  security.  The  applications
       have  limited  access  to the main system and user files. Access is granted solely through a whitelisting
       permissions file.

OPTIONS

       Pass the --help option to any subcommand in order to find its options.   The  following  subcommands  are
       available:

       subuser
              Add, remove, and configure subusers

       run    Run subusers

       repository
              Add and configure repositories

       update Update subuser images

       remove-old-images
              Remove unused images to free up disk space

       registry
              Interact with the subuser registry

       list   List subusers and images

       describe
              Describe subusers and images

       repair Repair your subuser installation. Useful after migrating to a new system.

       pkg    Create new subuser images

       dev    Use subuser to create portable and reproducible dev environments

       version
              Print subuser's version information

EXAMPLES

       To create a subuser named web-browsing based on the iceweasel image

              $ subuser subuser add web-browsing iceweasel@default

       To run that subuser

              $ subuser run web-browsing

       To  create  a  second  subuser,  also  based  on the iceweasel image, but this time reserved for internet
       banking

              $ subuser subuser add internet-banking iceweasel@default

       To run that subuser

              $ subuser run internet-banking

       To add a subuser to the PATH

              $ subuser subuser add-to-path internet-banking

       To update your subuser images

              $ subuser update all

       All updates are atomic, and you can continue to use your subusers while the update  command  is  running.
       If  you  find  that an older version of a subuser's image was better, you can always roll back the update
       for that subuser

              $ subuser registry log
              $ subuser lock-subuser-to internet-banking <commit-hash-from-log>

AUTHOR

       Timothy Hobbs (timothy.hobbs.cz)