Ubuntu Server Guide

Schema
The JSON schema for autoinstall data is as follows:
Regeneration
The schema above can be regenerated by running “make schema” in a subiquity source checkout.
Automated Server Installs Config File Reference
Overall format
The autoinstall file is YAML. At top level it must be a mapping containing the keys described in this
document. Unrecognized keys are ignored.
Schema
Autoinstall configs are validated against a JSON schema before they are used.
# Command lists
310

---

Several config keys are lists of commands to be executed. Each command can be a string (in which case it is
executed via “sh -c”) or a list, in which case it is executed directly. Any command exiting with a non-zero
return code is considered an error and aborts the install (except for error-commands, where it is ignored).
Top-level keys
## version
type: integer default: no default
A future-proofing config file version field. Currently this must be “1”.
## interactive-sections
type: list of strings default: []
A list of config keys to still show in the UI. So for example:
v e r s i o n : 1
i n t e r a c t i v e −s e c t i o n s :
− network
i d e n t i t y :
username : ubuntu
password : $crypt ed_ p a ss
Would stop on the network screen and allow the user to change the defaults. If a value is provided for an
interactive section it is used as the default.
You can use the special section name of ”*” to indicate that the installer should ask all the usual questions
– in this case, the autoinstall .yaml file is not really an “autoinstall” file at all, instead just a way to change
the defaults in the UI.
Not all config keys correspond to screens in the UI. This documentation indicates if a given section can be
interactive or not.
If there are any interactive sections at all, the reporting key is ignored.
## early-commands