Template:Networking rutos manual interfaces: Difference between revisions

From Teltonika Networks Wiki
No edit summary
m (Text replacement - "\{\{Template: Networking_rutos_manual_fw_disclosure (.*) (.*) (.*) (.*) \}\}" to "{{Template: Networking_device_manual_fw_disclosure | series = {{{series}}} | name = {{{name}}} | fw_version ={{Template: Networking_device_manual_latest_fw | series = {{{series}}} | name = {{{name}}} }} }}")
 
(48 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Template:Networking_rutos_manual_fw_disclosure
{{Template: Networking_device_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.02.05.1
| series = {{{series}}}
| series     = {{{series}}}
| name  = {{{name}}}
| fw_version ={{Template: Networking_device_manual_latest_fw
| series = {{{series}}}
| name  = {{{name}}}
}}
}}
}}


Line 18: Line 22:
The <b>Network Interfaces</b> section displays interfaces currently existing on this device.
The <b>Network Interfaces</b> section displays interfaces currently existing on this device.


[[File:Networking_rutos_manual_interfaces_network_interfaces_lan_{{{lan}}}_mobile_{{{mobile}}}_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}_wired_{{{wired}}}.png|border|class=tlt-border]]
{{#ifeq: {{{series}}} | TCR1 | [[File:Networking_rutos_manual_tcr1_interfaces_network_interfaces_v1.png|border|class=tlt-border]] |
[[File:Networking_rutos_manual_interfaces_network_interfaces_lan_{{{lan}}}_mobile_{{{mobile}}}_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}_wired_{{{wired}}}_v1{{#ifeq:{{{series}}}|TRB5|_trb5|}}.png|border|class=tlt-border]]|}}
 
==Add Interface==
==Add Interface==


Line 80: Line 86:
To begin configuring an interface, click the 'Edit' button on the right side of the interface:
To begin configuring an interface, click the 'Edit' button on the right side of the interface:


[[File:Networking_rutos_manual_interfaces_network_interfaces_edit_button_lan_{{{lan}}}.png]]
[[File:Networking_rutos_manual_interfaces_network_interfaces_edit_button_lan_{{{lan}}}{{#ifeq:{{{series}}}|TRB5|_trb5|}}.png]]


===General Setup===
===General Setup===
Line 100: Line 106:
     <tr>
     <tr>
       <td>IPv4 address</td>
       <td>IPv4 address</td>
       <td>ip4; default[for LAN]: <b>192.168.1.1</b></td>
       <td>ip4; default[for LAN]: <b>{{#switch:{{{series}}}|TRB1|TRB5=192.168.2.1|#default=192.168.1.1}}</b></td>
       <td>The IPv4 address interface of this interface. An IP address identifies a device on a network and allows it to communicate with other devices.</td>
       <td>The IPv4 address interface of this interface. An IP address identifies a device on a network and allows it to communicate with other devices.</td>
     </tr>
     </tr>
Line 206: Line 212:
The <b>Mobile</b> protocol is used to set up an interface which can establish a mobile WAN connection.
The <b>Mobile</b> protocol is used to set up an interface which can establish a mobile WAN connection.


=====Mode: NAT=====
----
[[File:Networking_rutos_manual_interfaces_interface_configuration_general_setup_mobile_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_general_setup_mobile_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]


Line 220: Line 228:
             <ul>
             <ul>
                 <li><b>NAT</b> - the mobile connection uses NAT (network address translation).</li>
                 <li><b>NAT</b> - the mobile connection uses NAT (network address translation).</li>
                 <li><span style="color: red;"><b>Bridge</b></span> - bridges the LTE data connection with LAN. The device assigns its WAN IP address to another device (first connected to LAN or specified with MAC address). Using Bridge mode will disable most of the device’s capabilities.</li>
                 <li><b>Bridge</b> - bridges the LTE data connection with LAN. The device assigns its WAN IP address to another device (first connected to LAN or specified with MAC address). Using Bridge mode will disable most of the device’s capabilities.</li>
                 <li><span style="color: cornflowerblue;"><b>Passthrough</b></span> - in this mode the {{{name}}} shares its WAN IP to a single LAN device (first connected to LAN or specified with MAC address). The LAN device will get WAN IP of {{{name}}} instead of LAN IP. Using Passthrough mode will disable most of the device’s capabilities.</li>
                <li><b>Passthrough</b> - in this mode the {{{name}}} shares its WAN IP to a single LAN device (first connected to LAN or specified with MAC address). The LAN device will get WAN IP of {{{name}}} instead of LAN IP. Using Passthrough mode will disable most of the device’s capabilities.</li>
            </ul>
        </td>
    <tr>
    <td>PDP Type</td>
        <td>IPv4 <nowiki>|</nowiki> IPv6 <nowiki>|</nowiki> IPv4/IPv6; default: <b>IPv4</b></td>
        <td>Specifies what of address will be requested from the operator.</td>
    </tr>
    </tr>{{#ifeq: {{{dualsim}}} | 1 | {{#ifeq: {{{dualmodem}}} | 1 ||
    <tr>
    <td>SIM</td>
        <td>SIM1 <nowiki>|</nowiki> SIM2; default: <b>SIM1</b></td>
        <td>Selects which SIM slot will be used for this interface.</td>
    </tr>}}|}}{{#ifeq: {{{dualmodem}}} | 1 |
    <tr>
    <td>Modem</td>
        <td>Primary modem <nowiki>|</nowiki> Secondary modem; default: <b>Primary modem</b></td>
        <td>Selects which modem will be used for this interface.</td>
    </tr>|}}
    <tr>
    <td>Auto APN</td>
        <td>off <nowiki>|</nowiki> on; default: <b>on</b></td>
        <td>The Auto APN feature scans an internal Android APN database and selects an APN based on the SIM card's operator and country. If the first automatically selected APN doesn't work, it attempts to use the next existing APN from the database.
        </td>
    </tr>
    <tr>
    <td>APN / Custom APN</td>
        <td>string; default: <b>none</b></td>
        <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require you to use an APN just to complete the registration on a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract.<br>An APN Network Identifier cannot start with any of the following strings:
            <ul>
                <li>rac;</li>
                <li>lac;</li>
                <li>sgsn;</li>
                <li>rnc;</li>
            </ul>it cannot end in:
            <ul>
                <li>.gprs;</li>
            </ul>and it cannot contain the asterisk symbol (<b>*</b>).
        </td>
    </tr>
    <tr>
    <td>Authentication Type</td>
        <td>NONE <nowiki>|</nowiki> PAP <nowiki>|</nowiki> CHAP; default: <b>NONE</b></td>
        <td>Authentication method that your GSM carrier uses to authenticate new connections on its network. If you select PAP or CHAP, you will also be required to enter a username and password.</td>
    </tr>
</table>
 
=====Mode: Passthrough=====
----
[[File:Networking_rutos_manual_interfaces_interface_configuration_general_mobile_passthrough_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
 
<table class="nd-mantable">
    <tr>
        <th>Field</th>
      <th>Value</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>Mode</td>
      <td>NAT <nowiki>|</nowiki> Bridge <nowiki>|</nowiki> Passthrough; default: <b>NAT</b></td>
      <td>Mobile connection operating mode.
            <ul>
                <li><b>NAT</b> - the mobile connection uses NAT (network address translation).</li>
                <li><b>Bridge</b> - bridges the LTE data connection with LAN. The device assigns its WAN IP address to another device (first connected to LAN or specified with MAC address). Using Bridge mode will disable most of the device’s capabilities.</li>
                 <li><b>Passthrough</b> - in this mode the {{{name}}} shares its WAN IP to a single LAN device (first connected to LAN or specified with MAC address). The LAN device will get WAN IP of {{{name}}} instead of LAN IP. Using Passthrough mode will disable most of the device’s capabilities.</li>
             </ul>
             </ul>
         </td>
         </td>
     </tr>{{#ifeq: {{{dualsim}}} | 1 |
     <tr>
    <td>Subnet selection</td>
        <td>Auto {{!}} P2P; default: <b>Auto</b></td>
        <td>Subnet selection method.</td>
    </tr>
     <tr>
     <tr>
     <td>PDP Type</td>
     <td>PDP Type</td>
Line 230: Line 306:
         <td>Specifies what of address will be requested from the operator.</td>
         <td>Specifies what of address will be requested from the operator.</td>
     </tr>  
     </tr>  
    </tr>{{#ifeq: {{{dualsim}}} | 1 | {{#ifeq: {{{dualmodem}}} | 1 ||
    <tr>
    <td>SIM</td>
        <td>SIM1 <nowiki>|</nowiki> SIM2; default: <b>SIM1</b></td>
        <td>Selects which SIM slot will be used for this interface.</td>
    </tr>}}|}}{{#ifeq: {{{dualmodem}}} | 1 |
    <tr>
    <td>Modem</td>
        <td>Primary modem <nowiki>|</nowiki> Secondary modem; default: <b>Primary modem</b></td>
        <td>Selects which modem will be used for this interface.</td>
    </tr>|}}
    <tr>
    <td>Auto APN</td>
        <td>off <nowiki>|</nowiki> on; default: <b>on</b></td>
        <td>The Auto APN feature scans an internal Android APN database and selects an APN based on the SIM card's operator and country. If the first automatically selected APN doesn't work, it attempts to use the next existing APN from the database.
        </td>
    </tr>
    <tr>
    <td>APN / Custom APN</td>
        <td>string; default: <b>none</b></td>
        <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require you to use an APN just to complete the registration on a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract.<br>An APN Network Identifier cannot start with any of the following strings:
            <ul>
                <li>rac;</li>
                <li>lac;</li>
                <li>sgsn;</li>
                <li>rnc;</li>
            </ul>it cannot end in:
            <ul>
                <li>.gprs;</li>
            </ul>and it cannot contain the asterisk symbol (<b>*</b>).
        </td>
    </tr>
    <tr>
    <td>Authentication Type</td>
        <td>NONE <nowiki>|</nowiki> PAP <nowiki>|</nowiki> CHAP; default: <b>NONE</b></td>
        <td>Authentication method that your GSM carrier uses to authenticate new connections on its network. If you select PAP or CHAP, you will also be required to enter a username and password.</td>
    </tr>
    <tr>
        <td>Disable DHCP</td>
        <td>on <nowiki>|</nowiki> off; default: <b>on</b></td>
        <td>Disables dynamic allocation of client addresses when toggled off</td>
    </tr>
    <tr>
        <td>Lease Time</td>
        <td>integer; default: <b>1</b></td>
        <td>Expiry time of leased address. The minimum value for hours is 1, the minimum value for minutes is 2 and the minimum value for seconds is 120</td>
    </tr>
    <tr>
        <td>Units</td>
        <td>Hours <nowiki>|</nowiki> Minutes <nowiki>|</nowiki> Second; default: <b>Hours</b></td>
        <td>Specifies the time measurement unit</td>
    </tr>
    <tr>
    <td>MAC Address</td>
        <td>mac; default: <b>none</b></td>
        <td>Specifies the MAC address of the device that will receive the mobile interface's IP address in Bridge or Passthrough mode.<br><b>Note:</b> this field only becomes visible when using Bridge or Passthrough mode.</td>
    </tr>
</table>
=====Mode: Bridge=====
----
[[File:Networking_rutos_manual_interfaces_interface_configuration_general_mobile_bridge_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
    <tr>
        <th>Field</th>
      <th>Value</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>Mode</td>
      <td>NAT {{!}} Bridge {{!}} Passthrough; default: <b>NAT</b></td>
      <td>Mobile connection operating mode.
            <ul>
                <li><b>NAT</b> - the mobile connection uses NAT (network address translation).</li>
                <li><b>Bridge</b> - bridges the LTE data connection with LAN. The device assigns its WAN IP address to another device (first connected to LAN or specified with MAC address). Using Bridge mode will disable most of the device’s capabilities.</li>
                <li><b>Passthrough</b> - in this mode the {{{name}}} shares its WAN IP to a single LAN device (first connected to LAN or specified with MAC address). The LAN device will get WAN IP of {{{name}}} instead of LAN IP. Using Passthrough mode will disable most of the device’s capabilities.</li>
            </ul>
        </td>
    <tr>
    <td>Subnet selection</td>
        <td>Auto {{!}} P2P; default: <b>Auto</b></td>
        <td>Subnet selection method.</td>
    </tr>
    <tr>
    <td>PDP Type</td>
        <td>IPv4 <nowiki>|</nowiki> IPv6 <nowiki>|</nowiki> IPv4/IPv6; default: <b>IPv4</b></td>
        <td>Specifies what of address will be requested from the operator.</td>
    </tr>{{#ifeq: {{{dualsim}}} | 1 | {{#ifeq: {{{dualmodem}}} | 1 ||
     <tr>
     <tr>
     <td>SIM</td>
     <td>SIM</td>
         <td>SIM1 <nowiki>|</nowiki> SIM2; default: <b>SIM1</b></td>
         <td>SIM1 <nowiki>|</nowiki> SIM2; default: <b>SIM1</b></td>
         <td>Selects which SIM slot will be used for this interface.</td>
         <td>Selects which SIM slot will be used for this interface.</td>
     </tr>|}}{{#ifeq: {{{dualmodem}}} | 1 |
     </tr>}}|}}{{#ifeq: {{{dualmodem}}} | 1 |
     <tr>
     <tr>
     <td>Modem</td>
     <td>Modem</td>
Line 267: Line 432:
     </tr>
     </tr>
     <tr>
     <tr>
     <td><span style="color: red;">Bridge</span> <nowiki>|</nowiki> <span style="color: cornflowerblue;">Passthrough</span>: MAC Address</td>
     <td>MAC Address</td>
         <td>mac; default: <b>none</b></td>
         <td>mac; default: <b>none</b></td>
         <td>Specifies the MAC address of the device that will receive the mobile interface's IP address in Bridge or Passthrough mode.<br><b>Note:</b> this field only becomes visible when using Bridge or Passthrough mode.</td>
         <td>Specifies the MAC address of the device that will receive the mobile interface's IP address in Bridge or Passthrough mode.<br><b>Note:</b> this field only becomes visible when using Bridge or Passthrough mode.</td>
     </tr>
     </tr>
</table>
</table>
{{#switch: {{{series}}}
| TRB1|TRB5|RUT36X =
| TRB2 =
{{#ifeq: {{{name}}} | TRB245 |
=====Multi-APN=====
----
{{{name}}} supports Multiple PDN feature in order to establish connections to multiple mobile networks using a single SIM card. You can find a configuration example [[Multi-APN|here]].}}
| #default =
=====Multi-APN=====
----
{{{name}}} supports Multiple PDN feature in order to establish connections to multiple mobile networks using a single SIM card. You can find a configuration example [[Multi-APN|here]].
}}
|}}
|}}


Line 282: Line 462:
<b>Advanced Settings</b> information for <b>Static</b> protocol is provided in the table below.
<b>Advanced Settings</b> information for <b>Static</b> protocol is provided in the table below.


[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_static.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_static_v3.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 289: Line 469:
         <th>Value</th>
         <th>Value</th>
         <th>Description</th>
         <th>Description</th>
    </tr>
    <tr>
        <td>Bring up on boot</td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether the interface should be launched during the boot process. If set to <i>off</i>, the interface would have to be brought up manually after each boot.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 304: Line 479:
         <td>off | on; default: <b>on</b></td>
         <td>off | on; default: <b>on</b></td>
         <td>Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.</td>
         <td>Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.</td>
    </tr>
    <tr>
        <td>Use gateway metric</td>
        <td>integer; default: <b>3</b></td>
        <td>A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 313: Line 493:
         <td>Override MTU</td>
         <td>Override MTU</td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.<br>
          <ul>
                <li>'''Note:''' Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.</li>
                <li>'''Note:''' Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.</li>
          </ul>   
        </td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Use gateway metric</td>
         <td>IP4table</td>
         <td>integer; default: <b>none</b></td>
         <td>integer [0..99999999]; default: <b>none</b></td>
         <td>A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).</td>
         <td>ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.</td>
     </tr>
     </tr>
    <tr>
<!--<tr>
         <td>IPv6 assignment length</td>
         <td>IPv6 assignment length</td>
         <td><span style="color: red;">integer [0..64]</span> | Disabled; default: <b>Disabled</b></td>
         <td>integer [0..64] | <span style="color: #1550bf; font-weight: bold;">Disabled</span>; default: <b>Disabled</b></td>
         <td>Delegates a prefix of given length to the interface.</td>
         <td>Delegates a prefix of given length to the interface.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>IPv6 address</td>
         <td><span style="color: #1550bf;">IPv6 address</span></td>
         <td>ip6; default: <b>none</b></td>
         <td>ip6; default: <b>none</b></td>
         <td>The interface's IPv6 address. An IP address identifies a device on a network and allows it to communicate with other devices.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i></td>
         <td>The interface's IPv6 address. An IP address identifies a device on a network and allows it to communicate with other devices.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i></td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color: red;">IPv6 gateway</span></td>
         <td><span style="color: #1550bf;">IPv6 gateway</span></td>
         <td>ip6; default: <b>none</b></td>
         <td>ip6; default: <b>none</b></td>
         <td>IPv6 prefix routed here for use on other interfaces.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i>.</td>
         <td>IPv6 prefix routed here for use on other interfaces.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i>.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>IPv6 routed prefix</td>
         <td><span style="color: #1550bf;">IPv6 routed prefix</span></td>
         <td>ip6; default: <b>none</b></td>
         <td>ip6; default: <b>none</b></td>
         <td>IPv6 prefix routed here for use on other interfaces.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i>.</td>
         <td>IPv6 prefix routed here for use on other interfaces.<br><b>Note:</b> this field only becomes visible when IPv6 assignment length is set to <i>disabled</i>.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color: red;">IPv6 assignment hint</span></td>
         <td>IPv6 assignment hint</td>
         <td>string; default: <b>none</b></td>
         <td>string; default: <b>none</b></td>
         <td>The subprefix-ID that should be delegated as hexadecimal number.</td>
         <td>Subprefix ID to be used if available (e.g., the value <i>1234</i> with an IPv6 assignment length of 64 will assign prefixes of the form …:1234::/64 or given LAN ports, LAN & LAN2, and a prefix delegation of /56, use IPv6 assignment hint of 00 and 80 which would give prefixes of LAN …:xx00::/64 and LAN2 …:xx80::/64)</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 350: Line 535:
         <td>When an IPv6 prefix (like 'a:b:c:d::') is received from a delegating server, use a suffix (like '::1') to form an IPv6 address ('a:b:c:d::1') for the interface. Leave empty to generate a random suffix.</td>
         <td>When an IPv6 prefix (like 'a:b:c:d::') is received from a delegating server, use a suffix (like '::1') to form an IPv6 address ('a:b:c:d::1') for the interface. Leave empty to generate a random suffix.</td>
     </tr>
     </tr>
-->
</table>
</table>


Line 356: Line 542:
<b>Advanced Settings</b> information for <i>DHCP</i> protocol is provided in the table below.
<b>Advanced Settings</b> information for <i>DHCP</i> protocol is provided in the table below.


[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_dhcp.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_dhcp_v4.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 363: Line 549:
         <th>Value</th>
         <th>Value</th>
         <th>Description</th>
         <th>Description</th>
    </tr>
    <tr>
        <td>Bring up on boot</td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether the interface should be launched during the boot process. If set to <i>off</i>, the interface would have to be brought up manually after each boot.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 388: Line 569:
         <td>off | on; default: <b>on</b></td>
         <td>off | on; default: <b>on</b></td>
         <td>When checked, creates a default route for the interface.</td>
         <td>When checked, creates a default route for the interface.</td>
    </tr>
    <tr>
        <td>Use DNS servers advertised by peer</td>
        <td><span style="color: red;">off</span> | on; default: <b>on</b></td>
        <td>Specifies whether to use DNS servers obtained automatically or specified manually.</td>
    </tr>
    <tr>
        <td><span style="color: red;">Use custom DNS servers</span></td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether to use DNS servers obtained automatically or specified manually.<br><b>Note:</b> this field only becomes visible when Use DNS servers advertised by peer is set to <i>off</i></td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 403: Line 574:
         <td>integer; default: <b>none</b></td>
         <td>integer; default: <b>none</b></td>
         <td>A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).</td>
         <td>A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).</td>
    </tr>
    <tr>
        <td>Use custom DNS servers</td>
        <td>ip4; default: <b>none</b></td>
        <td>Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used. </td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 422: Line 598:
         <td>Override MTU</td>
         <td>Override MTU</td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>Changes the interfaces allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
         <td>Changes the interfaces allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.<br>
          <ul>
                <li>'''Note:''' Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.</li>
                <li>'''Note:''' Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.</li>
          </ul></td>
    </tr>
    <tr>
        <td>IP4table</td>
        <td>integer [0..99999999]; default: <b>none</b></td>
        <td>ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.</td>
     </tr>
     </tr>
</table>
</table>
Line 430: Line 615:
<b>Advanced Settings</b> information for <i>DHCPv6</i> protocol is provided in the table below.
<b>Advanced Settings</b> information for <i>DHCPv6</i> protocol is provided in the table below.


[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_dhcpv6.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_dhcpv6_v4.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 437: Line 622:
         <th>Value</th>
         <th>Value</th>
         <th>Description</th>
         <th>Description</th>
    </tr>
    <tr>
        <td>Bring up on boot</td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether the interface should be launched during the boot process. If set to <i>off</i>, the interface would have to be brought up manually after each boot.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 459: Line 639:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Use DNS servers advertised by peer</td>
         <td>Use custom DNS servers</td>
         <td><span style="color: red;">off</span> | on; default: <b>on</b></td>
         <td>ip4; default: <b>none</b></td>
         <td>Specifies whether to use DNS servers obtained automatically or specified manually.</td>
         <td>Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used. </td>
    </tr>
    <tr>
        <td><span style="color: red;">Use custom DNS servers</span></td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether to use DNS servers obtained automatically or specified manually.<br><b>Note:</b> this field only becomes visible when Use DNS servers advertised by peer is set to <i>off</i></td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 486: Line 661:
         <td>Override MTU</td>
         <td>Override MTU</td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.<br>
          <ul>
                <li>'''Note:''' Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.</li>
                <li>'''Note:''' Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.</li>
          </ul></td>
    <tr>
     <tr>
     <tr>
        <td>IP4table</td>
        <td>integer [0..99999999]; default: <b>none</b></td>
        <td>ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.</td>
    </tr>
</table>
</table>


Line 494: Line 678:
<b>Advanced Settings</b> information for <i>PPPoE</i> protocol is provided in the table below.
<b>Advanced Settings</b> information for <i>PPPoE</i> protocol is provided in the table below.


[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_pppoe.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_pppoe_v5.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 501: Line 685:
         <th>Value</th>
         <th>Value</th>
         <th>Description</th>
         <th>Description</th>
    </tr>
    <tr>
        <td>Bring up on boot</td>
        <td>off | on; default: <b>on</b></td>
        <td>Specifies whether the interface should be launched during the boot process. If set to <i>off</i>, the interface would have to be brought up manually after each boot.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 533: Line 712:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Use DNS servers advertised by peer</td>
         <td>Use custom DNS servers</td>
         <td><span style="color: red;">off</span> | on; default: <b>on</b></td>
        <td>ip4; default: <b>none</b></td>
         <td>Specifies whether to use DNS servers obtained automatically or specified manually.</td>
        <td>Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used. </td>
    </tr>
    <tr>
         <td>VLAN tag value</td>
        <td>integer [0..7]; default: <b>none</b></td>
         <td>VLAN tag value.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color: red;">Use custom DNS servers</span></td>
         <td>VLAN priority</td>
         <td>off | on; default: <b>on</b></td>
         <td>integer [0..4095]; default: <b>none</b></td>
         <td>Specifies whether to use DNS servers obtained automatically or specified manually.<br><b>Note:</b> this field only becomes visible when Use DNS servers advertised by peer is set to <i>off</i></td>
         <td>VLAN priority.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 566: Line 750:
         <td>integer [1..1500]; default: <b>none</b></td>
         <td>integer [1..1500]; default: <b>none</b></td>
         <td>Maximum Transmission Unit (MTU) – specifies the largest possible size of a data packet.</td>
         <td>Maximum Transmission Unit (MTU) – specifies the largest possible size of a data packet.</td>
    </tr>
    <tr>
        <td>IP4table</td>
        <td>integer [0..99999999]; default: <b>none</b></td>
        <td>ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.</td>
     </tr>
     </tr>
</table>
</table>
Line 573: Line 762:
<b>Advanced Settings</b> information for <i>Mobile</i> protocol is provided in the table below.
<b>Advanced Settings</b> information for <i>Mobile</i> protocol is provided in the table below.


[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_mobile_dualsim_{{{dualsim}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_advanced_settings_mobile_dualsim_{{{dualsim}}}_v5.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 580: Line 769:
         <th>Value</th>
         <th>Value</th>
         <th>Description</th>
         <th>Description</th>
    </tr>
    <tr>
        <td>Bring up on boot</td>
        <td>off <nowiki>|</nowiki> on; default: <b>on</b></td>
        <td>Specifies whether the interface should be launched during the boot process. If set to <i>off</i>, the interface would have to be brought up manually after each boot.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 597: Line 781:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Use DNS servers advertised by peer</td>
         <td>Use custom DNS servers</td>
         <td><span style="color: red;">off</span> <nowiki>|</nowiki> on; default: <b>on</b></td>
         <td>ip4; default: <b>none</b></td>
         <td>Specifies whether to use DNS servers obtained automatically or specified manually.</td>
         <td>Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used. </td>
    </tr>
    <tr>
        <td><span style="color: red;">Use custom DNS servers</span></td>
        <td>off <nowiki>|</nowiki> on; default: <b>on</b></td>
        <td>Specifies whether to use DNS servers obtained automatically or specified manually.<br><b>Note:</b> this field only becomes visible when Use DNS servers advertised by peer is set to <i>off</i></td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 615: Line 794:
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>integer [1..9200]; default: <b>none</b></td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
         <td>Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
    </tr>
    <tr>
        <td>IP4table</td>
        <td>integer [0..99999999]; default: <b>none</b></td>
        <td>ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.</td>
     </tr>
     </tr>
</table>|}}
</table>|}}
===Physical Settings===
===Physical Settings===
----
----
The <b>Physical Settings</b> section is used to create associations with physical interfaces and bridge network interfaces.
The <b>Physical Settings</b> section is used to create associations with physical interfaces and bridge network interfaces.


[[File:Networking_rutos_manual_interfaces_interface_configuration_physical_settings.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_physical_settings_v2.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 631: Line 816:
     <tr>
     <tr>
         <td>Bridge interfaces</td>
         <td>Bridge interfaces</td>
         <td>off | <span style="color: red;">on</span>; default: <b>off</b></td>
         <td>off | <span style="color: #1550bf; font-weight: bold;">on</span>; default: <b>on</b></td>
         <td>Bridges physical interfaces specified in this configuration.</td>
         <td>Bridges physical interfaces specified in this configuration.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color: red;">Enable STP</span></td>
         <td>Enable STP</td>
        <td>off | on; default: <b>off</b></td>
        <td>Turns the use of Spanning Tree Protocol (STP) for this interface on or off.<br><b>Note:</b> this field becomes visible when 'Bridge interfaces' is set to <i>on</i>.</td>
    </tr>
    <tr>
        <td>Enable IGMP</td>
         <td>off | on; default: <b>off</b></td>
         <td>off | on; default: <b>off</b></td>
         <td>Turns the use of Spanning Tree Protocol (STP) for this interface on or off.<br><b>Note:</b> this field becomes visible when 'Bridge interfaces' is set to <i>on</i></td>
         <td>Enabless IGMP snooping on this bridge.<br><b>Note:</b> this field becomes visible when 'Bridge interfaces' is set to <i>on</i> and 'Protocol' is set to <i>PPPoE</i>.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 678: Line 868:
[[File:Networking_rutx_manual_lan_static_dhcp_server_scheme_v1.png]]
[[File:Networking_rutx_manual_lan_static_dhcp_server_scheme_v1.png]]


<u>In order to view the DHCP server configuration, the interface <b>protocol must be set to <i>Static</i></b></i>.</u>
<i>To make the DHCP Server section visible, <b>set interface protocol to Static</b>.</i>


====DHCP Server: General Setup====
====DHCP Server: General Setup====
Line 684: Line 874:
The <b>General Setup</b> section is used to set up the main operating parameters of the DHCP server.
The <b>General Setup</b> section is used to set up the main operating parameters of the DHCP server.


[[File:Networking_rutos_manual_interfaces_interface_configuration_dhcp_server_general_setup_lan_{{{lan}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_dhcp_server_general_setup_lan_{{{lan}}}_v1.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 698: Line 888:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Start</td>
         <td>Start IP</td>
         <td>integer [1..255]; default: <b>100</b></td>
         <td>ip4; default: <b>{{#switch:{{{series}}}|TRB1|TRB5=192.168.2.100|#default=192.168.1.100}}</b></td>
         <td>The starting IP address value. e.g., if your device’s LAN IP is 192.168.1.1 and your subnet mask is 255.255.255.0 that means that in your network a valid IP address has to be in the range of [192.168.1.0..192.168.1.254] (192.168.1.255 is a special unavailable address). If the Start value is set to 100 then the DHCP server will only lease out addresses starting from 192.168.1.<b>100</b>.</td>
         <td>The starting IP address of the DHCP server IP address range. E.g., if your device’s LAN IP is {{#switch:{{{series}}}|TRB1|TRB5=192.168.2.1|#default=192.168.1.1}} and your subnet mask is 255.255.255.0 that means that in your network a valid IP address has to be in the range of [{{#switch:{{{series}}}|TRB1|TRB5=192.168.2.0|#default=192.168.1.0}}..{{#switch:{{{series}}}|TRB1|TRB5=192.168.2.254|#default=192.168.1.254}}] ({{#switch:{{{series}}}|TRB1|TRB5=192.168.2.255|#default=192.168.1.255}} is a special unavailable address). If the subnet of your LAN IP address changes, this value needs to be changed accordingly.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Limit</td>
         <td>End IP</td>
         <td>integer [1..255]; default: <b>150</b></td>
         <td>ip4; default: <b>{{#switch:{{{series}}}|TRB1|TRB5=192.168.2.249|#default=192.168.1.249}}</b></td>
         <td>How many addresses the DHCP server can lease out. Continuing from the example above: if the start address is 192.168.1.100 and the server can lease out 150 addresses, available addresses will be from 192.168.1.<b>100</b> to 192.168.1.<b>249</b> (<i>100 + 150 – 1 = 249</i>; this is because the first address is inclusive).</td>
         <td>The ending IP address of the DHCP server IP address range. Continuing from the example above: if the start address is {{#switch:{{{series}}}|TRB1|TRB5=192.168.2.<b>100</b>|#default=192.168.1.<b>100</b>}} and the end address is {{#switch:{{{series}}}|TRB1|TRB5=192.168.2.<b>249</b>|#default=192.168.1.<b>249</b>}}, available addresses will be distributed from that range. If the subnet of your LAN IP address changes, this value needs to be changed accordingly.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Lease time</td>
         <td>Lease time</td>
         <td>integer [2..999999]m/h; default: <b>12h</b></td>
         <td>integer [1..999999]; default: <b>12</b><br>integer [2..999999]<span class="asterisk">*</span><br>integer [120..999999]<span class="asterisk">**</span></td>
         <td>A DHCP lease will expire after the amount of time specified in this field and the device that was using the lease will have to request a new one. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes (e.g., if lease time is 12 hours, then every 6 hours the device will ask the DHCP server to renew its lease).<br>The minimal amount of time that can be specified is 2 minutes.</td>
         <td>A DHCP lease will expire after the amount of time specified in this field and the device that was using the lease will have to request a new one. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes (e.g., if lease time is 12 hours, then every 6 hours the device will ask the DHCP server to renew its lease).<br>The minimal amount of time that can be specified is 2 minutes.<br><span class="asterisk">*</span>If selected Units is Minutes.<br><span class="asterisk">**</span>If selected Units is seconds.</td>
    </tr>
    <tr>
        <td>Units</td>
        <td>Hours | Minutes | Seconds; default: <b>Hours</b></td>
        <td>Lease time units.</td>
     </tr>
     </tr>
</table>
</table>
Line 722: Line 917:
Refer to the table below for information on the <b>Advanced Settings</b> section.
Refer to the table below for information on the <b>Advanced Settings</b> section.


[[File:Networking_rutos_manual_interfaces_interface_configuration_dhcp_server_advanced_settings.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_dhcp_server_advanced_settings_v2.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 749: Line 944:
         <td>dhcp options; default: <b>none</b></td>
         <td>dhcp options; default: <b>none</b></td>
         <td>Additional options to be added to the DHCP server. For example with '26,1470' or 'option:mtu, 1470' you can assign an MTU value per DHCP. You can find more information on DHCP Options [https://technet.microsoft.com/en-us/library/cc958941.aspx here].</td>
         <td>Additional options to be added to the DHCP server. For example with '26,1470' or 'option:mtu, 1470' you can assign an MTU value per DHCP. You can find more information on DHCP Options [https://technet.microsoft.com/en-us/library/cc958941.aspx here].</td>
    </tr>
    <tr>
        <td>Force DHCP options</td>
        <td>off | on; default: <b>off</b></td>
        <td>If enabled, DHCP options will be sent even if it's not requested.</td>
     </tr>
     </tr>
</table>
</table>
Line 805: Line 1,005:
<b>Static IP leases</b> are used to reserve specific IP addresses for specific devices by binding them to their MAC address. This is useful when you have a stationary device connected to your network that you need to reach frequently, e.g., printer, IP phone, etc.
<b>Static IP leases</b> are used to reserve specific IP addresses for specific devices by binding them to their MAC address. This is useful when you have a stationary device connected to your network that you need to reach frequently, e.g., printer, IP phone, etc.


This section displays static IP leases currently existing on this device. <u>In order to view the Static Lease section, the interface <b>protocol must be set to <i>Static</i></b></i>.</u>
This section displays static IP leases currently existing on this device.
 
<i>To make the Static Lease section visible, <b>set interface protocol to Static</b>.</i>
----
----
The Static Lease list is empty by default. To add a new Static Lease look to the Add Lease section; enter a custom name for the lease and click the 'Add' button.
The Static Lease list is empty by default. To add a new Static Lease look to the Add Lease section; enter a custom name for the lease and click the 'Add' button.
Line 841: Line 1,043:
----
----
The <b>Relay Configuration</b> section is used to relay and dynamically redirect incoming connections to a target host. Its main purpose is extending the wireless network. For example, when the device is in Wireless Station (client) mode, it can be used to bridge WAN and LAN interfaces to create a larger wireless network.<br>You can find a detailed usage example <b>[[Relayd|here]]</b>.
The <b>Relay Configuration</b> section is used to relay and dynamically redirect incoming connections to a target host. Its main purpose is extending the wireless network. For example, when the device is in Wireless Station (client) mode, it can be used to bridge WAN and LAN interfaces to create a larger wireless network.<br>You can find a detailed usage example <b>[[Relayd|here]]</b>.
{{#switch: {{{series}}}
  | #default =
  | RUT36X|RUT9|TCR1 =
<u><b>


<u>In order to view the Relay Configuration section, the interface <b>protocol must be set to <i>Static</i></b></i>.</u>
Note:</b> Relay is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u>
}}


[[File:Networking_rutos_manual_interfaces_interface_configuration_relay_configuration.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_relay_configuration.png|border|class=tlt-border]]
Line 863: Line 1,070:
     </tr>
     </tr>
</table>|}}
</table>|}}
{{#ifeq: {{{mobile}}} | 1 |
 
===UDP Broadcast Relay===
----
The <b>UDP Broadcast Relay</b> will listen for broadcast traffic on the specified port and relay that traffic to the specified interface(s).
 
<i><b>Note:</b> UDP Broadcast Relay is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</i>
 
[[File:Networking_rutos_manual_interfaces_interface_configuration_udp_broadcast_relay.png|border|class=tlt-border]]
 
<table class="nd-mantable">
    <tr>
        <th>Field</th>
      <th>Value</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>Enable</td>
      <td>off <nowiki>|</nowiki> on; default: <b>off</b></td>
      <td>Turns UDP Broadcast Relay on or off.</td>
    </tr>
    <tr>
    <td>Port</td>
        <td>integer [0..655353]; default: <b>none</b></td>
        <td>UDP port to listen for broadcast traffic.</td>
    </tr>
    <tr>
    <td>Interfaces</td>
        <td>network interface(s); default: <b>none</b></td>
        <td>The interface(s) to which the traffic will be redirected to.</td>
    </tr>
</table>
{{#ifeq:{{{series}}}|TRB5||{{#ifeq: {{{mobile}}} | 1 |
===Mobile Data Limit===
===Mobile Data Limit===
----
----
The <b>Mobile Data Limit</b> section provides you with the possibility to set data usage limits for your mobile network interfaces and data usage warnings via SMS message in order to protect yourself from unwanted data charges.
The <b>Mobile Data Limit</b> section provides you with the possibility to set data usage limits for your mobile network interfaces and data usage warnings via SMS message in order to protect yourself from unwanted data charges.


<u>In order to view the Mobile Data Limit section, the interface <b>protocol must be set to <i>Mobile</i></b></i>.</u>
<i>In order to view the Mobile Data Limit section, the interface <b>protocol must be set to Mobile</b>.</i>


[[File:Networking_rutos_manual_interfaces_interface_configuration_mobile_mobile_data_limit.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_interfaces_interface_configuration_mobile_mobile_data_limit_v2.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 911: Line 1,149:
         <td>phone number; default: <b>none</b></td>
         <td>phone number; default: <b>none</b></td>
         <td>Recipient's phone numbers.</td>
         <td>Recipient's phone numbers.</td>
    </tr>
    <tr>
    <td>Data limit clear due</td>
        <td><b>none</b></td>
        <td>Display the date of the next automatic data limit clear.</td>
     </tr>
     </tr>
</table>
</table>


<font size="-1"><span class="asterisk">*</span>Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.</font>|}}
<font size="-1"><i><span class="asterisk">*</span>Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.</i></font>|}}}}


[[Category:{{{name}}} Network section]]
[[Category:{{{name}}} Network section]]

Latest revision as of 11:08, 24 October 2023

The information in this page is updated in accordance with firmware version .

Summary

The Interfaces page is used to to set up network interfaces.

This manual page provides an overview of the Interfaces page in {{{name}}} devices.

If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.

Network Interfaces

The Network Interfaces section displays interfaces currently existing on this device.

[[File:Networking_rutos_manual_interfaces_network_interfaces_lan_{{{lan}}}_mobile_{{{mobile}}}_dualsim_{{{dualsim}}}_dualmodem_{{{dualmodem}}}_wired_{{{wired}}}_v1.png|border|class=tlt-border]]

Add Interface

The Add Interface section is used to create additional network interfaces. To create a new interface, simply enter a custom name for it and click the 'Add' button.

Interface configuration

This section provides information on network interface configuration. There are {{{no_of_if}}} main types of interfaces on the device:

  • Ethernet LAN

Different types of interfaces can be configured under different protocols:

Static DHCP DHCPv6 PPPoE
Ethernet LAN

To begin configuring an interface, click the 'Edit' button on the right side of the interface:

[[File:Networking_rutos_manual_interfaces_network_interfaces_edit_button_lan_{{{lan}}}.png]]

General Setup


The General Setup section is used to configure the protocol of an interface and all the different parameters that go along with each protocol. If None protocol is chosen, all other interface settings will be ignored. The following sections are different for each protocol.

General Setup: Static


The static protocol uses a predefined manual configuration instead of obtaining parameters automatically via a DHCP lease.

[[File:Networking_rutos_manual_interfaces_interface_configuration_general_setup_static_ip_lan_{{{lan}}}.png|border|class=tlt-border]]

Field Value Description
IPv4 address ip4; default[for LAN]: 192.168.1.1 The IPv4 address interface of this interface. An IP address identifies a device on a network and allows it to communicate with other devices.
IPv4 netmask netmask; default[for LAN]: 255.255.255.0 The IPv4 netmask of this interface. A netmask is used to define how "large" a network is by specifying which part of the IP address denotes the network and which part denotes a device.
IPv4 gateway ip4; default: none The IPv4 gateway address used by this interface. An interface's default gateway is the default address through which all outgoing traffic is directed.
IPv4 broadcast ip4; default: none The IPv4 broadcast address used by this interface. IP broadcasts are used by BOOTP and DHCP clients to find and send requests to their respective servers.
DNS servers ip4; default: none DNS server addresses that this interface will use. If left empty, DNS servers are assigned automatically. To see what DNS servers are currently used, you can check the contents of the /tmp/resolv.conf.auto file.

General Setup: DHCP


The DHCP protocol is used to set up an interface which obtains its configuration parameters automatically via a DHCP lease.

Field Value Description
Hostname to send when requesting DHCP string; default: none A hostname for this interface used to identify this machine on the DHCP server.

General Setup: DHCPv6


The DHCPv6 protocol is used to set up an IPv6 interface which obtains its configuration parameters automatically via a DHCP lease.

Field Value Description
Request IPv6-address try | force | disabled; default: try Defines the behaviour for requesting an address.
Request IPv6-prefix of length integer [0..64] | Automatic | disabled ; default: Automatic Defines how this will request a IPv6 ULA-Prefix length. If set to 'disabled' the interface will obtain a single IPv6 address without a subnet for routing.

General Setup: PPPoE


The PPPoE protocol is used to set up a PPP (Point-to-Point Protocol) connection over the Ethernet port.

Field Value Description
PAP/CHAP username string; default: none Username used in PAP/CHAP authentication.
PAP/CHAP password string; default: none Password used in PAP/CHAP authentication.
Access Concentrator string; default: none The Access Concentrator to connect to. ISPs used Access Concentrators to route their PPPoE connections. Usually, the settings are received automatically, however in some cases it is required to specify the name for an Access Concentrator. Leave empty to detect Access Concentrators automatically.
Service name string; default: none The Service Name to connect to. Leave empty to detect Service name automatically.


Advanced Settings


The Advanced Settings section is used to set up some of the more specific and less frequently used interface parameters. This section is different for each protocol.

Advanced Settings: Static


Advanced Settings information for Static protocol is provided in the table below.

Field Value Description
Use built in IPv6-management off | on; default: on Specifies whether to enable prefix delegation.
Force link off | on; default: on Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.
Use gateway metric integer; default: 3 A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).
Override MAC address mac; default: none When set, uses a user-defined MAC address for the interface instead of the default one.
Override MTU integer [1..9200]; default: none Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.
  • Note: Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.
  • Note: Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.
IP4table integer [0..99999999]; default: none ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.

Advanced Settings: DHCP


Advanced Settings information for DHCP protocol is provided in the table below.

Field Value Description
Use built-in IPv6 management off | on; default: on Specifies whether to enable prefix delegation.
Force link off | on; default: off Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.
Use broadcast flag off | on; default: off Required for certain ISPs. For example, Charter with DOCSIS 3.
Use default gateway off | on; default: on When checked, creates a default route for the interface.
Use gateway metric integer; default: none A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).
Use custom DNS servers ip4; default: none Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used.
Client ID to send when requesting DHCP string; default: none Client ID which will be sent when requesting a DHCP lease.
Vendor Class to send when requesting DHCP string; default: none Vendor class which will be sent when requesting a DHCP lease.
Override MAC address mac; default: none When set, uses a user-defined MAC address for the interface instead of the default one.
Override MTU integer [1..9200]; default: none Changes the interfaces allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.
  • Note: Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.
  • Note: Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.
IP4table integer [0..99999999]; default: none ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.

Advanced Settings: DHCPv6


Advanced Settings information for DHCPv6 protocol is provided in the table below.

Field Value Description
Use built in IPv6-management off | on; default: on Specifies whether to enable prefix delegation.
Force link off | on; default: off Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.
Use default gateway off | on; default: on When checked, creates a default route for the interface.
Use custom DNS servers ip4; default: none Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used.
Custom delegated IPv6-prefix ip6 prefix; default: none Uses an (additional) user-provided IPv6 prefix for distribution to clients.
Client ID to send when requesting DHCP string; default: none Client ID which will be sent when requesting a DHCP lease.
Override MAC address mac; default: none When set, uses a user-defined MAC address for the interface instead of the default one.
Override MTU integer [1..9200]; default: none Changes the interface's allowed maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.
  • Note: Interface(s): lan have mtu lower than 1280 it will make all interfaces on same physical interface no longer support IPv4.
  • Note: Interface(s): lan have mtu lower than 576 it will make all interfaces on same physical interface no longer support DHCP.
IP4table integer [0..99999999]; default: none ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.

Advanced Settings: PPPoE


Advanced Settings information for PPPoE protocol is provided in the table below.

Field Value Description
Use built-in IPv6 management off | on; default: on Specifies whether to enable prefix delegation.
Force link off | on; default: off Specifies whether interface settings (IP, route, gateway) are assigned to the interface regardless of the link being active or only after the link has become active.
Obtain IPv6 address Automatic | Disabled | Manual; default: Automatic Defines behaviour for obtaining an IPv6 address.
Use default gateway off | on; default: on When checked, creates a default route for the interface.
Use gateway metric integer; default: none A metric specifies the priority of the gateway. The lower the metric, the higher the priority (0 for highest priority).
Use custom DNS servers ip4; default: none Specifies custom DNS servers. If left empty, DNS servers advertised by peer are used.
VLAN tag value integer [0..7]; default: none VLAN tag value.
VLAN priority integer [0..4095]; default: none VLAN priority.
LCP echo failure threshold integer; default: none Presumes peer to be dead after given amount of LCP echo failures. Leave it at 0 to ignore failures.
LCP echo interval integer; default: none Sends LCP echo requests at the given interval in seconds. This function is only effective in conjunction with failure threshold.
Host-Uniq tag content raw hex-encoded bytes; default: none Leave empty unless your ISP require this.
Inactivity timeout mac; default: none Close inactive connection after the given amount of seconds. Leave it at 0 to persist connection.
Override MTU integer [1..1500]; default: none Maximum Transmission Unit (MTU) – specifies the largest possible size of a data packet.
IP4table integer [0..99999999]; default: none ID of the routing table in [[{{{name}}}_Routing#Routing_Tables|Routing tables]] page.


Physical Settings


The Physical Settings section is used to create associations with physical interfaces and bridge network interfaces.

Field Value Description
Bridge interfaces off | on; default: on Bridges physical interfaces specified in this configuration.
Enable STP off | on; default: off Turns the use of Spanning Tree Protocol (STP) for this interface on or off.
Note: this field becomes visible when 'Bridge interfaces' is set to on.
Enable IGMP off | on; default: off Enabless IGMP snooping on this bridge.
Note: this field becomes visible when 'Bridge interfaces' is set to on and 'Protocol' is set to PPPoE.
Interface network interface(s); default: none Ties this network interface to physical device interfaces such as Ethernet .

Firewall Settings


The Firewall Settings section is used to specify to which firewall zone if any this interface belongs. Assigning an interface to a zone may provide easier configuration of firewall rules. For example, instead of configuring separate rules for each WAN interface, you can add all WAN interfaces into a single firewall zone and make the rule apply to that zone instead.

More firewall zone settings can be configured from the Network → Firewall → General Settings → [[{{{name}}}_Firewall#Zones|Zones]] section.

Field Value Description
Create / Assign firewall-zone firewall zone; default: none Assigns this interface to the specified firewall zone.

DHCP Server


A DHCP (Dynamic Host Configuration Protocol) server is a service that can automatically configure the TCP/IP settings of any device that requests such a service. If you connect a device that has been configured to obtain an IP address automatically, the DHCP server will lease out an IP address from the available IP pool and the device will be able to communicate within the private network.

To make the DHCP Server section visible, set interface protocol to Static.

DHCP Server: General Setup


The General Setup section is used to set up the main operating parameters of the DHCP server.

[[File:Networking_rutos_manual_interfaces_interface_configuration_dhcp_server_general_setup_lan_{{{lan}}}_v1.png|border|class=tlt-border]]

Field Value Description
Enable DHCP Enable | Disable | DHCP Relay*; default: Enable Turns the DHCP server on or off or enables DHCP relay*.
If DHCP Relay* is selected, you will be prompted to enter an IP address of another DHCP server in your LAN. In this case, whenever a new machine connects to this device, it will redirect any DHCP requests to the specified DHCP Server.
Start IP ip4; default: 192.168.1.100 The starting IP address of the DHCP server IP address range. E.g., if your device’s LAN IP is 192.168.1.1 and your subnet mask is 255.255.255.0 that means that in your network a valid IP address has to be in the range of [192.168.1.0..192.168.1.254] (192.168.1.255 is a special unavailable address). If the subnet of your LAN IP address changes, this value needs to be changed accordingly.
End IP ip4; default: 192.168.1.249 The ending IP address of the DHCP server IP address range. Continuing from the example above: if the start address is 192.168.1.100 and the end address is 192.168.1.249, available addresses will be distributed from that range. If the subnet of your LAN IP address changes, this value needs to be changed accordingly.
Lease time integer [1..999999]; default: 12
integer [2..999999]*
integer [120..999999]**
A DHCP lease will expire after the amount of time specified in this field and the device that was using the lease will have to request a new one. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes (e.g., if lease time is 12 hours, then every 6 hours the device will ask the DHCP server to renew its lease).
The minimal amount of time that can be specified is 2 minutes.
*If selected Units is Minutes.
**If selected Units is seconds.
Units Hours | Minutes | Seconds; default: Hours Lease time units.

* When an interface is set to act as a DHCP Relay, it redirects all received DHCP request messages to another specified DHCP server:

DHCP Server: Advanced Settings


Refer to the table below for information on the Advanced Settings section.

Field Value Description
Dynamic DHCP off | on; default: on Enables dynamic allocation of client addresses. If this is disabled, only clients that have static IP leases will be served.
Force off | on; default: off The DHCP force function ensures that the device will always start it’s DHCP server, even if there is another DHCP server already running in the its network. By default the device’s DHCP server will not start when it is connected to a network segment that already has a working DHCP server.
IPv4 Netmask netmask; default: none Sends a different netmask than the LAN netmask to DHCP clients.
DHCP Options dhcp options; default: none Additional options to be added to the DHCP server. For example with '26,1470' or 'option:mtu, 1470' you can assign an MTU value per DHCP. You can find more information on DHCP Options here.
Force DHCP options off | on; default: off If enabled, DHCP options will be sent even if it's not requested.

DHCP Server: IPv6 Settings


Refer to the table below for information on the IPv6 Settings section.

Field Value Description
Router Advertisement Service Disabled | Relay mode | Server mode | Hybrid mode; default: Disabled Specifies whether router advertisements should be enabled (server mode), relayed or disabled.
DHCPv6 Service Disabled | Relay mode | Server mode | Hybrid mode; default: Disabled Specifies whether DHCPv6 server should be enabled (server), relayed (relay) or disabled (disabled).
NDP Proxy Disabled | Relay mode | Hybrid mode; default: Disabled Specifies whether NDP should be relayed or disabled.
DHCPv6 Mode Stateless | Stateful-only | Stateless + stateful; default: Stateless + stateful Router announcement (RA) mode.
Always announce default router off | on; default: off Default router lifetime in the the router announcement (RA) message will be set if default route is present and a global IPv6 address or if default route is present but no global IPv6 address or neither of both conditions.
Announced DNS server ip; default: none Supplements DHCP-assigned DNS server entries with ones specified in this field.
Announced DNS domains ip; default: none DNS domain handed out to DHCP clients.

Static Lease


Static IP leases are used to reserve specific IP addresses for specific devices by binding them to their MAC address. This is useful when you have a stationary device connected to your network that you need to reach frequently, e.g., printer, IP phone, etc.

This section displays static IP leases currently existing on this device.

To make the Static Lease section visible, set interface protocol to Static.


The Static Lease list is empty by default. To add a new Static Lease look to the Add Lease section; enter a custom name for the lease and click the 'Add' button.

You should be redirected to the Settings page for that lease, which should look similar to this:

Field Value Description
MAC address mac; default: none MAC address of a device that will connect to this network interface.
IP address ip; default: none The IP address that will be reserved for the specified device.

After you click 'Save & Apply' you will be redirected back to the Network Interfaces page. If you wish to modify the lease later, you can find in the Static Lease list. Simply click the 'Edit' button next to it in order to enter the Settings page for the Static Lease.


UDP Broadcast Relay


The UDP Broadcast Relay will listen for broadcast traffic on the specified port and relay that traffic to the specified interface(s).

Note: UDP Broadcast Relay is additional software that can be installed from the System → [[{{{name}}} Package Manager|Package Manager]] page.

Field Value Description
Enable off | on; default: off Turns UDP Broadcast Relay on or off.
Port integer [0..655353]; default: none UDP port to listen for broadcast traffic.
Interfaces network interface(s); default: none The interface(s) to which the traffic will be redirected to.


[[Category:{{{name}}} Network section]]