===================================================
Installing a node on an existing Linux installation
===================================================

Nodes can also be manually installed on an existing Linux server. Presently,
the software is supported for the following distributions:

- openSUSE Leap 15.6
- openSUSE Leap 15.5

.. warning::

    If you intend to install and configure a node using a node key, ensure that
    a corresponding node record with a working interface and address
    configuration has been created on the management server before continuing.
    More information about adding, editing, and deleting node records and
    configuring interfaces and addresses can be found in the `node management
    <../node-management/index.html>`__ and `interfaces and addressing
    <../../interfaces-and-addressing/index.html>`__ documentation.

Instructions
============

1. On the management server web interface, locate and click on the **Install**
   button on the node's details page:

|installing-a-node-on-an-existing-linux-installation-1|

2. This will open up a modal with further installation steps:

|installing-a-node-on-an-existing-linux-installation-2|

3. Copy the instructions highlighted above into your Linux terminal and run
   them. Ensure you are connected to the internet. This will install the
   SD-WAN software on the device along with any required packages.

.. warning::

    If a node key is provided and the networking in the configuration is not
    valid for the network the device is attached to, any previously configured
    network access will be lost during this process. Ensure that the network
    configuration is correct before configuring via node key.

If a node key was provided, this will finish setting up the node and associate
it with its record on the management server. Otherwise, a default node
configuration will be used until a node key is provided at a later time.
Note that default node configurations will run DHCP on all available
interfaces. See the following links for more information on configuring default
nodes:

- `Configuring a default node via web service <configuring-a-default-node-via-web-service.html>`__
- `Configuring a default node or reconfiguring an existing node via USB key <configuring-a-default-node-or-reconfiguring-an-existing-node-via-usb-key.html>`__

.. |installing-a-node-on-an-existing-linux-installation-1| image:: /attachments/laywire/nodes/installing-a-node-on-an-existing-linux-installation-1.png
    :scale: 75%
.. |installing-a-node-on-an-existing-linux-installation-2| image:: /attachments/laywire/nodes/installing-a-node-on-an-existing-linux-installation-2.png
    :scale: 75%