Interfaces
Interfaces
The Interfaces page configures the network interfaces or the server.
Interfaces Grid
The Interfaces tab shows the current interfaces and the current status and some configuration information.
The are several columns along the top of the grid that show the current interface status and configuration. Some are hidden by default.
Columns
Column | Description |
---|---|
Id | The Id is a unique integer primary key of the interface. All configuration of interfaces will refer to Id. |
Name | This is a name/description of the interface. It is recommended to choose names representative of their purpose. |
Connected | This shows the current "connected" state of the device currently mapped to this interface. This may not display correctly for all network interface cards. |
Device | This shows the current network device (physical NIC card or wireless card) mapped to this interface. |
Physical Device | Hidden by default, this shows the current "Physical Device" for this interface. |
System Device | Hidden by default, this shows the current "System Device" for this interface. |
Symbolic Device | Hidden by default, this shows the current "Symbolic Device" for this interface. |
Config | This shows the current type of configuration for this interface. ADDRESSED, BRIDGED, or DISABLED. |
Current Address | This shows the current address if there is one of the interface. |
is WAN | This shows true if the interface is configured as a WAN, false otherwise. |
Delete | This column shows an delete button on VLAN Tagged Interfaces to delete the interface. Physical interfaces can not be deleted, unless their their physical devices have been removed from the system. |
Edit | This column shows an edit button to edit the configuration of this interface. |
There are also several options along the bottom.
- Remap Interfaces
- This utility can be used to change the mapping between physical devices and the corresponding interface configurations. This is useful if you want to use certain physical devices for certain purpose. For example, the gigabit cards for internal and external networks and the 100Mbit card for wireless because its only wireless.
- Refresh Device Status
- This refreshes the "Connected" column in the interfaces grid. To verify your interface mapping plug/unplug one network card at a time and hit Refresh Device Status to verify that the expected interface changes the Connected status.
- Add VLAN Tagged Interface
- This allows for additional of 802.1q VLAN tagged interfaces. For more information read Network Configuration#VLANs.
- Test Connectivity
- This button launches the connectivity test to verify the server is online.
- Ping Test
- This button launches the ping test for troubleshooting configuration.
Interface Configuration
Clicking the edit button on an interface will open the interface configuration settings for that interface.
An interface can be configured in many ways. Some settings and configuration options are only relevant and/or available in certain configurations. As such, based on an interface's configuration certain options may appear and disappear. For example, when checking 'is WAN' the options available to WAN interfaces will appear. After unchecking 'is WAN' the WAN options will disappear and the options for non-WAN interfaces will appear. Because of this it is suggested to configure your interface from the top of the page downward.
The table below shows the various configuration options and their meanings.
Interface Options
Option | Description |
---|---|
Interface Name | This is a name/description of the interface. It is recommended to choose names representative of their purpose. |
is VLAN (802.1q) Interface | This is true if this a tagged VLAN interface. Otherwise this is not shown |
Parent Interface | This is the parent interface for this tagged VLAN interface. This is only shown for VLAN interfaces. |
802.1q Tag | This is the VLAN tag for this interface. This is only shown for VLAN interfaces. |
Is Wireless Interface | This is available if the interface is detected as a wireless (wlan) interface. Otherwise this is not shown. |
Config Type | This is the basic configuration type of this interfaces. Addressed means this interface has its own address and configuration. Bridged means this interface is bridged to another interface. Disabled means this interface is entirely disabled. |
is WAN Interface | This should be checked if this is a WAN (Wide Area Network) interface. This means it is connected to your ISP or an internet connection. This should be unchecked if this interface is connected to a private/local network. |
Wireless Configuration - This section configures the wireless settings for wireless interfaces. This is only shown for wireless interfaces.
Option | Description |
---|---|
SSID | The broadcasted Service Set Identifier (SSID) for the wireless network. |
Mode | AP (Access Point) or Client. |
Visibility | Select whether to advertise or hide the SSID. |
Encryption | Encryption method used for the wireless signal. WPA2 is recommended. |
Password | When encryption is enabled, a password will be required to access the network. |
Channel | Choose from the available channels available and 2.4GHz or 5GHz frequencies. The options available here are dependent on your wireless card. WARNING: Many chips/drivers do not correctly implement "Automatic" (ACS or Automatic Channel Survey) so it may not work depending on your card. NOTICE: Automatic channel selection has been removed from modern builds due to lack of support and usability issues. |
IPv4 Options - This section configures the IPv4 (Internet Protocol v4) settings of this interface.
Option | Description |
---|---|
Config Type | This is the IPv4 configuration type. Static means this interface has a static IPv4 address. Auto (DHCP) means this interface will use DHCP to automatically acquire an address. PPPoE means this interface will use PPPoE to acquire an address. This option is only available for WAN interfaces because non-WANs can only be statically configured. |
Address | This is the IPv4 static address. It is only shown if Config Type is Static |
Netmask | This is the IPv4 static netmask. It is only shown if Config Type is Static |
Gateway | This is the IPv4 static gateway. It is only shown if Config Type is Static |
Primary DNS | This is the primary DNS used for DNS resolution. It is only shown if Config Type is Static |
Secondary DNS | This is the secondary DNS used for DNS resolution. It is only shown if Config Type is Static |
Address Override | If set, this address will be used instead of the one in the offered DHCP lease. It is only shown if Config Type is Auto (DHCP) |
Netmask Override | If set, this netmask will be used instead of the one in the offered DHCP lease. It is only shown if Config Type is Auto (DHCP) |
Gateway Override | If set, this gateway will be used instead of the one in the offered DHCP lease. It is only shown if Config Type is Auto (DHCP) |
Primary DNS Override | If set, this will be used instead of the one in the offered DHCP lease. It is only shown if Config Type is Auto (DHCP) |
Secondary DNS Override | If set, this will be used instead of the one in the offered DHCP lease. It is only shown if Config Type is Auto (DHCP) |
Username | This is the PPPoE username. It is only shown in Config Type PPPoE |
Password | This is the PPPoE password. It is only shown in Config Type PPPoE |
Use Peer DNS | If checked the server will use the DNS provided by the PPPoE server for DNS resolution. It is only shown in Config Type PPPoE |
Primary DNS | The primary DNS to be used for DNS resolution. It is only shown in Config Type PPPoE and Use Peer DNS is unchecked. |
Secondary DNS | The secondary DNS to be used for DNS resolution. It is only shown in Config Type PPPoE and Use Peer DNS is unchecked. |
IPv4 Aliases | This is a list of alias addresses. This is an additional list of addresses that this interface will have along with their associated netmasks. |
IPv4 Options - NAT traffic exiting this interface (and bridged peers) | This option is only available on WAN Interfaces and defaults to checked. If checked all traffic exiting this interface and interfaces bridged to it will be NATd, and all incoming sessions from this interface will be blocked unless they are forwarded via a port forward or destined to the local server. |
IPv4 Options - NAT traffic coming from this interface (and bridged peers) | This option is only available on non-WAN Interfaces and defaults to unchecked. If checked all traffic coming from this interface and interfaces bridged to it will be NATd, and all incoming sessions to this interface will be blocked unless they are forwarded via a port forward. |
IPv6 Options - This section configures the IPv6 (Internet Protocol v6) settings of this interface.
Option | Description |
---|---|
Config Type | This is the IPv6 configuration type. Disabled means the interface has no IPv6 configuration. Static means this interface has a static IPv6 address. Auto (SLAAC/RA) means this interface will use SLAAC to automatically acquired an address. This option is only available for WAN interfaces because non-WANs can only be statically configured. |
Address | This is the IPv6 static address. Blank is allowed and means no IPv6 address will be given. It is only shown if Config Type is Static |
Prefix | This is the IPv6 static prefix. It is only shown if Config Type is Static |
Gateway | This is the IPv6 static gateway. It is only shown if Config Type is Static |
Primary DNS | This is the primary DNS used for DNS resolution. It is only shown if Config Type is Static |
Secondary DNS | This is the secondary DNS used for DNS resolution. It is only shown if Config Type is Static |
IPv6 Aliases | This is a list of alias addressed. This is an additional list of addresses that this interface will have along with their associated netmasks. This is only available on non-WAN interfaces. |
IPv6 Options - Send Router Advertisements | If checked route advertisements are sent on this interface. This is only available on non-WAN interfaces. |
DHCP Configuration - This configures the DHCP serving options on this interfaces. DHCP Serving is only available on Addressed non-WAN interfaces.
Option | Description |
---|---|
Enable DHCP Serving | If checked, DHCP will be served to this interface so that machines can automatically acquire addresses. |
Range Start | The start of the DHCP range. |
Range end | The end of the DHCP range. |
Lease duration | The duration of the provided DHCP leases in seconds. |
Gateway Override | If set, this value will be provided as the gateway in the DHCP leases. Otherwise the static IPv4 address of this interface will be provided as the gateway. |
Netmask Override | If set, this value will be provided as the netmask in the DHCP leases. Otherwise the static IPv4 netmask of this interface will be provided as the netmask. |
DNS Override | If set, this value will be provided as the DNS in the DHCP leases. Otherwise the static IPv4 address of this interface will be provided as the DNS. A single IPv4 address or a comma-separated list of IPv4 addresses is accepted. |
DHCP Options | This is a list of DHCP options for dnsmasq. WARNING: this option is for advanced users. The specified DHCP options will be used on this interface. For example, to specify an NTP server use enabled = true, description = "time server", and value = "42,192.168.1.2". For multiple DNS override servers specify enabled = true, description = "DNS", and value = "6,192.168.1.1,192.168.1.2". The value must be specified in a valid dnsmasq format as described in the dnsmasq documentation |
Redundancy (VRRP) Configuration - This configures the VRRP redundancy options for this interface. VRRP is only available on statically assigned interfaces. VRRP documentation is here.
Option | Description |
---|---|
Enable VRRP | If checked, VRRP is enabled on this interface. |
VRRP ID | The VRRP (group) ID of this server. Must match the VRRP ID of peers, but must be unique on the server. |
VRRP Priority | The VRRP Priority of this server. Higher value is a higher priority. (1-255) |
VRRP Aliases | The list of VRRP Virtual Addresses. This list should be the same on all VRRP peers. |
Interface Status
The status button on the interface brings up a window showing some of the statistics about the interface. This includes statistics, the ARP table, and the connected clients if its a wireless interface.