Configuration

Configuring Joot

Where does the config file live?

Joot looks for the config file in these locations and uses the first file it finds:

1. File pointed to by the environment variable JOOT_CONFIG
2. ~/.joot where ~ denotes the user's home directory
3. /etc/joot.cfg

Valid Configuration Settings

setting	default	description
joot_home	/var/joot	images and joots go here, so make sure this location has plenty of free space
sockets_dir	/var/run/joot	joot sometimes needs to create unix domain sockets. Those go here.
image_sources	none	array of URLs to index files pointing to images. See Publishing Images for a description of the index files
copy_from_root	none	array of files to be copied into the joot from the root at create time
pass_thru_env	none	joot will escalate to root (by calling sudo) for you. It will pass these environment variables to the cmd that sudo executes with the env cmd
plugins	none	See the Plugins documentation

Example Config file

The config file format is "relaxed" JSON, which means it allows for shell-style '#'-comments and lists with trailing commas.

{
    "joot_home": "/var/joot/",
    "sockets_dir": "/var/run/joot/",
    "image_sources": [
        "http://getjoot.org/images/index.js",
    ],
    "copy_from_root": [
        "/etc/resolv.conf", 
        "/etc/localtime"
    ],
    "pass_thru_env": [ "SSH_AUTH_SOCK", "JOOT_CONFIG" ],
    "plugins": [
        "QCOW",
        "BindMount",
        "Users",
        "SudoUsers"
    ]
}