The site configuration

Every CHI-in-a-Box deployment is highly configurable, though many settings are defaulted to what Chameleon considers the most useful or likely scenario. Some configuration values like hostnames or private IP addresses do not have defaults and must be specified by the operator. These settings are specified as part of a site configuration, which is a folder containing a few important files:


  • an Ansible Vault password file

  • an (encrypted) passwords YAML file

  • a defaults.yaml file used to configure most settings. These defaults apply in a low-priority and can be overridden via Ansible inventory host_vars or group_vars.

  • an (optional) post-deploy YAML file, which is an Ansible playbook that can be run after normal post-deploy steps via cc-ansible post-deploy. This is a useful place to put additional settings that need to be invoked via Ansible, such as setting up tagged VLAN interfaces or custom firewall rules.

A directory with examples is located in the CHI-in-a-Box repo at ./site-config.example

Last updated