summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Breunig <christian@breunig.cc>2025-01-02 22:24:47 +0100
committerChristian Breunig <christian@breunig.cc>2025-01-02 22:24:47 +0100
commit3fdab89e5c28485b7f4c3e9a492e51235077edd9 (patch)
treeda184cbd53c56a7c3cb6adc5c65bf96f935f1348
parent82de7860efeb6cf08c406c197e8746fa972d8784 (diff)
downloadvyos-documentation-locally-administered-macs.tar.gz
vyos-documentation-locally-administered-macs.zip
installation: add note about unsupported locally administered MAC addresseslocally-administered-macs
-rw-r--r--docs/installation/index.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/installation/index.rst b/docs/installation/index.rst
index 9ab43b0e..7cdd9c29 100644
--- a/docs/installation/index.rst
+++ b/docs/installation/index.rst
@@ -2,6 +2,17 @@
Installation and Image Management
#################################
+.. note:: This is most likely only relevant for virtual installations:
+
+ When installing VyOS ensure that the MAC address selected for your NICs is
+ not a locally administered MAC address. Locally administered addresses are
+ distinguished from universally administered addresses by setting (assigning
+ the value of 1 to) the second-least-significant bit of the first octet of
+ the address:
+
+ Example: ``02:00:00:00:00:01``, where the second-least-significant bit
+ (``02`` in hex) is set to ``1``.
+
.. toctree::
:maxdepth: 2
:caption: Content