==========================================
Configuring a default node via web service
==========================================

Nodes can be installed with a default node configuration. This means they are
not assigned to a specific node record on the management server. This is useful
if you want to keep a supply of unconfigured nodes that can be shipped to
customers and assigned to a node record at a later time.

One option to finalize node configuration is to use the web service
``sdwan.local``. The following guide explains how this works.

.. note::
    To set up a device as a default node, refer to the node `ISO installation
    <installing-a-node-via-iso.html>`__ or `existing Linux installation
    <installing-a-node-on-an-existing-linux-installation.html>`__
    documentation.

Connecting to the internet
==========================

To configure a default node via web service, you must first ensure that the
node can acquire internet access by having at least one interface plugged into
a network that provides DHCP.

Accessing the web service
=========================

The node configuration web service is served over HTTP, and can be accessed via
the local service URL ``sdwan.local``. This is a special address that is
automatically broadcast on unconfigured nodes via mDNS. To configure the node,
simply point the web browser to this URL from a computer on the same local
subnet as the device.

Configuring the node
====================

.. note::

    This method is only available on unconfigured nodes. If the node has
    already been assigned to a record on the management server, it must be
    reset to the default configuration first. More information can be found in
    the `node reset documentation
    <resetting-a-node-to-the-default-configuration.html>`__.

1. Open a web browser and navigate to the URL ``sdwan.local``:

|configuring-a-default-node-via-web-service-1|

2. Enter the node key for the node record you wish to assign this node to, and
   click **Submit**:

|configuring-a-default-node-via-web-service-2|

3. The configuration has been downloaded from the management server onto the
   node. Your node is now configured.

|configuring-a-default-node-via-web-service-3|

.. |configuring-a-default-node-via-web-service-1| image:: /attachments/laywire/nodes/configuring-a-default-node-via-web-service-1.png
    :scale: 75%
.. |configuring-a-default-node-via-web-service-2| image:: /attachments/laywire/nodes/configuring-a-default-node-via-web-service-2.png
    :scale: 75%
.. |configuring-a-default-node-via-web-service-3| image:: /attachments/laywire/nodes/configuring-a-default-node-via-web-service-3.png
    :scale: 75%