===================================
Adding, editing, and deleting nodes
===================================

Node records are configured entirely via the management web interface.

.. contents::
    :local:
    :depth: 1

Adding a node
=============

To add a node, click the **Add node** button located underneath the heading on
the node list page:

|adding-editing-and-deleting-nodes-1|

From here you can specify the following information. Fields marked with an
asterisk are required.

Name *
------

A descriptive name for the node.

Space *
-------

The space the node will be assigned to. The space determines which users can
see and manage the node.

Administrative profile *
------------------------

The administrative profile assigned to the node. The default profile will be
used if unset.

Groups
------

Any node groups you would like the node to be a part of. See the `node group
documentation <../../node-groups/index.html>`__ for more information.

Metadata
--------

Optional data about the node, in key-value pairs. This is purely user-defined.
It can be used to store data such as location and CRM identifiers.

Note
----

Any miscellaneous information you would like to include about the node.

Once you have entered your information, click on **Save** to add the node.
You will then be directed to the newly created node's details page.

Editing a node
==============

To edit a node record, navigate to the node's details page by clicking on its
name in the node list:

|adding-editing-and-deleting-nodes-2|

From here you can edit any of the properties of the node that were specified
when it was created, as well as manage any interfaces, peers, nexthops, routes,
and access rules for the node. More information on these can be found in the
`interface and address documentation
<../../interfaces-and-addressing/index.html>`__, the `peer documentation
<../../peers/index.html>`__, the routing documentation, and the `access rules
documentation <../../access-rules/index.html>`__.

To edit the node's name, click the |edit| button that appears next to the name
when you hover over it:

|adding-editing-and-deleting-nodes-3|

To edit the node's space, click the |edit| button that appears next to the
space name when you hover over it:

|adding-editing-and-deleting-nodes-4|

To edit any node groups the node is in, click the |add| button next to the
**Groups** heading in the node details.

To edit node metadata, click the |edit| button next to the **Metadata** heading
in the node details.

Deleting a node
===============

To delete a node, navigate to the node's details page and click the **Delete**
button underneath the node's name:

|adding-editing-and-deleting-nodes-5|

This will open up a modal asking you to confirm before the node record is
permanently deleted.

.. |adding-editing-and-deleting-nodes-1| image:: /attachments/laywire/nodes/adding-editing-and-deleting-nodes-1.png
    :scale: 75%
.. |adding-editing-and-deleting-nodes-2| image:: /attachments/laywire/nodes/adding-editing-and-deleting-nodes-2.png
    :scale: 75%
.. |adding-editing-and-deleting-nodes-3| image:: /attachments/laywire/nodes/adding-editing-and-deleting-nodes-3.png
    :scale: 75%
.. |adding-editing-and-deleting-nodes-4| image:: /attachments/laywire/nodes/adding-editing-and-deleting-nodes-4.png
    :scale: 75%
.. |adding-editing-and-deleting-nodes-5| image:: /attachments/laywire/nodes/adding-editing-and-deleting-nodes-5.png
    :scale: 75%

.. |add| image:: /attachments/laywire/add.svg
    :width: 20px
.. |edit| image:: /attachments/laywire/edit.svg
    :width: 20px
.. |delete| image:: /attachments/laywire/delete.svg
    :width: 20px