man(1)

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)