Skip to content

Extra Configuration Options


Just a list of available configuration options that can be used inside /usbkey/config

This page is a work-in-progress, and the information here should probably be refactored onto other pages.  Examples here aren't guaranteed to be accurate with current builds of SmartOS.

Additional NICs


The nic_tag can be any short alpha string to name the newly added NIC. The _mac line is optional. If not used, a randomly-generated mac address will be assigned to the instance on each boot.

There two predefined nic_tag's:

  • admin - used for the private admin only network or as default NIC if only one interface is available
  • external - used for connecting to the outer world


Key Value Description
headnode_default_gateway aaa.bbb.ccc.ddd The def ault gateway's IP-address If this value is not set the admin_gateway is used
dns_resolvers aaa.bbb.ccc.ddd,aaa.bbb.ccc.ddd List of one or more nameservers separated by comma
dns_domain The default search domain. Can be any valid domain name
ntp_hosts List of one or more NTP servers separated by comma. This setting is only used if ntp_conf_file is not set
coal true Set up the GZ to NAT for Coal. This se tting depends on two defined nic_tags admin and external and wi ll use the configured networks to set up NAT for zones on the external NIC

Console / Login / SSH keys

Key Value Description
root_shadow <password-hash> Can be set to a password hash for the root user. This setting is only used if the boot parameter root_shadow is not set and the file /usbkey/s hadow does not exist
default_keymap us This sets the default keycap for all local logins. Valid values/filenames can be found here: /usr/share/lib/keytables/type_6/.

Including files

Files saved under /usbkey/ can be included. Key-value pairs in /usbkey/config are set to the path to the file relative to /usbkey/, and do not have default values. (See source code.)

Key Example Value Description
root_authorized_keys_file authorized_keys This file is copied to /root/.ssh/authorized_keys for public key authentication on login. The exact commands to set this up can be found on the SmartOS global zone tweaks blog post.
ntp_conf_file ntp.conf This file is copied to /etc/inet/ntp.conf and overrides the ntp_hosts variable

OS configuration options

Key Example Value Description
smt_enabled false Whether SMT siblings are enabled on the CPU. Defaults to true.


Key Example Value Description
datacenter_name Any string Define a name for the datacenter. This will be in /.dcinfo and can be sourced in scripts


These are not proved to work everywhere - they "work for me"

Single NIC with auto configured NAT

The used MAC addresses for admin_nic and external_nic can match. So this one physical NIC gets tagged as admin and external.

# This file was auto-generated and must be source-able by bash.

# admin_nic is the nic admin_ip will be connected to for headnode zones.