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 appliance uplinks settings configuration using tested YAML configuration from pipeline fixtures.

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:
                    interfaces:
                      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"