Appliance Uplink Settings

Dashboard Location: Security and SD-WAN > Configure > SD-WAN & Traffic Shaping

Appliance Uplink Management

Appliance uplink settings in Meraki provide comprehensive WAN interface configuration including IP assignment modes, VLAN tagging, PPPoE authentication, and dual-stack IPv4/IPv6 support. This functionality enables organizations to configure diverse internet connectivity scenarios, implement redundant WAN connections, and support complex network topologies while maintaining centralized management and automatic failover capabilities. Uplink configuration is essential for SD-WAN deployments, ensuring optimal connectivity and network resilience across distributed environments.

Diagram

Classes

appliance (meraki.domains.organizations.networks.devices)

Name	Type	Constraint	Mandatory	Default Value
uplinks_settings	Class	`[uplinks_settings]`	No

uplinks_settings (meraki.domains.organizations.networks.devices.appliance)

Name	Type	Constraint	Mandatory	Default Value
wan1	Class	`[wan1]`	No
wan2	Class	`[wan2]`	No

wan1 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings)

Name	Type	Constraint	Mandatory
enabled	Boolean	`true`, `false`	No
vlan_tagging	Class	`[vlan_tagging]`	No
svis	Class	`[svis]`	No
pppoe	Class	`[pppoe]`	No

wan2 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings)

Name	Type	Constraint	Mandatory
enabled	Boolean	`true`, `false`	No
vlan_tagging	Class	`[vlan_tagging]`	No
svis	Class	`[svis]`	No
pppoe	Class	`[pppoe]`	No

vlan_tagging (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1)

Name	Type	Constraint	Mandatory	Default Value
enabled	Boolean	`true`, `false`	No
vlan_id	Any	Integer[min: `1`, max: `4094`] or String[matches: `(?:[1-9]	[1-9][0-9]	[1-9][0-9]2

svis (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1)

Name	Type	Constraint	Mandatory	Default Value
ipv4	Class	`[ipv4]`	No
ipv6	Class	`[ipv6]`	No

pppoe (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1)

Name	Type	Constraint	Mandatory	Default Value
enabled	Boolean	`true`, `false`	No
authentication	Class	`[authentication]`	No

vlan_tagging (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2)

Name	Type	Constraint	Mandatory	Default Value
enabled	Boolean	`true`, `false`	No
vlan_id	Any	Integer[min: `1`, max: `4094`] or String[matches: `(?:[1-9]	[1-9][0-9]	[1-9][0-9]2

svis (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2)

Name	Type	Constraint	Mandatory	Default Value
ipv4	Class	`[ipv4]`	No
ipv6	Class	`[ipv6]`	No

pppoe (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2)

Name	Type	Constraint	Mandatory	Default Value
enabled	Boolean	`true`, `false`	No
authentication	Class	`[authentication]`	No

ipv4 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1.svis)

Name	Type	Constraint	Mandatory
assignment_mode	Choice	`dynamic`, `static`	No
address	String	min: `1`, max: `1024`	No
gateway	IP		No
nameservers	List	IP	No

ipv6 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1.svis)

Name	Type	Constraint	Mandatory
assignment_mode	Choice	`dynamic`, `static`	No
address	String	min: `1`, max: `1024`	No
gateway	IP		No
nameservers	List	IP	No

authentication (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan1.pppoe)

Name	Type	Constraint	Mandatory
enabled	Boolean	`true`, `false`	No
username	String	min: `1`, max: `127`	No
password	String	min: `5`, max: `64`	No

ipv4 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2.svis)

Name	Type	Constraint	Mandatory
assignment_mode	Choice	`dynamic`, `static`	No
address	String	min: `1`, max: `1024`	No
gateway	IP		No
nameservers	List	IP	No

ipv6 (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2.svis)

Name	Type	Constraint	Mandatory
assignment_mode	Choice	`dynamic`, `static`	No
address	String	min: `1`, max: `1024`	No
gateway	IP		No
nameservers	List	IP	No

authentication (meraki.domains.organizations.networks.devices.appliance.uplinks_settings.wan2.pppoe)

Name	Type	Constraint	Mandatory
enabled	Boolean	`true`, `false`	No
username	String	min: `1`, max: `127`	No
password	String	min: `5`, max: `64`	No

Examples

Example-1: The example below demonstrates uplinks settings configuration.

This configuration manages WAN uplink interfaces and connectivity parameters. The example includes interface settings, load balancing, and failover configurations for reliable internet connectivity and SD-WAN functionality.

This configuration establishes dual WAN interfaces with WAN1 using “enabled: true”, dynamic IPv4 assignment (“assignment_mode: dynamic”), and “pppoe: enabled: false” for standard DHCP connectivity, while WAN2 enables VLAN tagging (“vlan_tagging: enabled: true, vlan_id: 200”) and PPPoE authentication with “enabled: true”, “username: pppoe_user”, and “password: securepassword”. The configuration supports both IPv4 and IPv6 connectivity options (shown in comments) including static addressing, gateway settings, and DNS nameserver configurations for comprehensive dual-stack networking. This setup enables redundant internet connectivity with different connection types (DHCP vs PPPoE) and VLAN segmentation for diverse ISP requirements.

meraki:
  domains:
    - name: !env domain
      administrator:
        name: !env org_admin
      organizations:
        - name: !env org
          networks:
            - name: !env network_name
              product_types:
                - appliance
                - switch
                - wireless
                - camera
                - sensor
                - cellularGateway
              devices:
                - name: !env appliance_01
                  appliance:
                    uplinks_settings:
                      wan1:
                        enabled: true
                        svis:
                          ipv4:
                            assignment_mode: dynamic
                          # ipv6:
                          #   assignment_mode: static
                          #   address: "2001:db8::2/64"
                          #   gateway: "2001:db8::1"
                          #   nameservers:
                          #     addresses:
                          #       - "2001:4860:4860::8888"
                          #       - "2001:4860:4860::8844"
                        pppoe:
                          enabled: false
                      wan2:
                        enabled: true
                        vlan_tagging:
                          enabled: true
                          vlan_id: 200
                        # svis:
                        #   ipv4:
                        #     assignment_mode: static
                        #     address: 192.168.2.1
                        #     gateway: 192.168.2.254
                        #     nameservers:
                        #       addresses:
                        #         - 8.8.8.8
                        #   # ipv6:
                        #   #   assignment_mode: dynamic
                        pppoe:
                          enabled: true
                          authentication:
                            enabled: true
                            username: "pppoe_user"
                            password: "securepassword"