Product SiteDocumentation Site

8.2.4. Network Boot Options

Initial network initialization is handled by dracut. This section only lists some of the more commonly used options; for a complete list, see the dracut.cmdline(7) man page. Additional information on networking is also available in the Fedora Networking Guide, available at http://docs.fedoraproject.org/.
ip=
Configures one or more network interfaces. To configure multiple interfaces, use the ip option multiple times - once for each interface. If multiple interfaces are configured, you must specify a primary boot interface using the bootdev option described below.
The following table lists valid values for this option:
Table 8.4. Network Interface Configuration Formats
Configuration Method Option format
Automatic configuration of any interface ip=method
Automatic configuration of a specific interface ip=interface:method
Static configuration ip=ip::gateway:netmask:hostname:interface:none
Automatic configuration of a specific interface with an override [a] ip=ip::gateway:netmask:hostname:interface:method:mtu
[a] Brings up the specified interface using the specified method of automatic configuration, such as dhcp, but overrides the automatically obtained IP address, gateway, netmask, hostname or other specified parameter. All parameters are optional; only specify the ones you wish to override and automatically obtained values will be used for the others.

The method parameter can be any the following:
Table 8.5. Automatic Interface Configuration Methods
Automatic configuration method Value
DHCP dhcp
IPv6 DHCP dhcp6
IPv6 automatic configuration auto6
iBFT (iSCSI Boot Firmware Table) ibft

Note

If you use a boot option which requires network access, such as inst.ks=http://host:/path, without specifying the ip option, the installation program will use ip=dhcp.
In the above tables, the ip parameter specifies the client's IP address. IPv6 addresses can be specified by putting them in square brackets, for example, [2001:DB8::1].
The gateway parameter is the default gateway. IPv6 addresses are accepted here as well.
The netmask parameter is the netmask to be used. This can either be a full netmask (for example 255.255.255.0) or a prefix (for example 64).
The hostname parameter is the host name of the client system. This parameter is optional.
nameserver=
Specifies the address of the name server. This option can be used multiple times.
bootdev=
Specifies the boot interface. This option is mandatory if you use more than one ip option.
ifname=
Assigns a given interface name to a network device with a given MAC address. Can be used multiple times. The syntax is ifname=interface:MAC. For example:
ifname=eth0:01:23:45:67:89:ab
inst.dhcpclass=
Specifies the DHCP vendor class identifier. The dhcpd service will see this value as vendor-class-identifier. The default value is anaconda-$(uname -srm).
vlan=
Sets up a Virtual LAN (VLAN) device on a specified interface with a given name. The syntax is vlan=name:interface. For example:
vlan=vlan5:em1
The above will set up a VLAN device named vlan5 on the em1 interface. The name can take the following forms:
Table 8.6. VLAN Device Naming Conventions
Naming scheme Example
VLAN_PLUS_VID vlan0005
VLAN_PLUS_VID_NO_PAD vlan5
DEV_PLUS_VID em1.0005.
DEV_PLUS_VID_NO_PAD em1.5.

bond=
Set up a bonding device with the following syntax: bond=name[:slaves][:options]. Replace name with the bonding device name, slaves with a comma-separated list of physical (ethernet) interfaces, and options with a comma-separated list of bonding options. For example:
bond=bond0:em1,em2:mode=active-backup,tx_queues=32,downdelay=5000
For a list of available options, execute the modinfo bonding command.
Using this option without any parameters will assume bond=bond0:eth0,eth1:mode=balance-rr.
team=
Set up a team device with the following syntax: team=master:slaves. Replace master with the name of the master team device and slaves with a comma-separated list of physical (ethernet) devices to be used as slaves in the team device. For example:
team=team0:em1,em2
inst.waitfornet=X
Use this option to force Anaconda to wait for X seconds before starting the interactive installer or an interactive installation. This is a maximum value - if a network connection is established before X seconds pass, the installation will proceed normally from that point.