HorizonScript Keys
Introduction A HorizonScript file is, at its core, a collection of values that determine the actions and configuration values used to transform a computer from an indeterminate state to a well-known state running Adélie Linux. These values are categorised into keys, which is a logical unit of a value. This chapter defines and specifies for every valid key for a HorizonScript file: its name, its purpose, its format, and one or more example values with explanations.
Required Keys Each key in this section is required to be present in a HorizonScript. If any key from this section is missing, the HorizonScript will be considered invalid and Horizon Runner will not execute it.
<literal>network</literal> Name network Purpose The network key determines if the target computer will support networking or not. If the value is true, the computer will support networking, and at least one netaddress key will then be required. Format The network key is a Boolean value — valid values are true and false. network must appear exactly once in a HorizonScript. Example The <literal>network</literal> Key network true This enables networking for the target computer.
<literal>hostname</literal> Name hostname Purpose The hostname key determines the hostname of the target computer. This key is always required, even when the target computer will not participate in a network. The computer's hostname is used on shell prompts, most window manager launchers, and in log files. Format The hostname key is a string value that must contain only alphanumeric characters and optionally one or more '.' characters. If hostname contains one or more '.' characters, all content before the first '.' is considered the hostname, and all content after the first '.' is considered the domain name. Examples The <literal>hostname</literal> Key — Setting a Host Name hostname gwyn This sets the hostname of the target computer to gwyn. The <literal>hostname</literal> Key — Setting a Host Name and Domain Name hostname gwyn.foxkit.internal This sets the hostname of the target computer to gwyn.foxkit.internal.