aboutsummaryrefslogtreecommitdiff
path: root/docs/source/markdown/options/mac-address.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/markdown/options/mac-address.md')
-rw-r--r--docs/source/markdown/options/mac-address.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/source/markdown/options/mac-address.md b/docs/source/markdown/options/mac-address.md
new file mode 100644
index 000000000..0939ceaad
--- /dev/null
+++ b/docs/source/markdown/options/mac-address.md
@@ -0,0 +1,11 @@
+#### **--mac-address**=*address*
+
+<<Container|Pod>> network interface MAC address (e.g. 92:d0:c6:0a:29:33)
+This option can only be used if the <<container|pod>> is joined to only a single network - i.e., **--network=_network-name_** is used at most once -
+and if the <<container|pod>> is not joining another container's network namespace via **--network=container:_id_**.
+
+Remember that the MAC address in an Ethernet network must be unique.
+The IPv6 link-local address will be based on the device's MAC address
+according to RFC4862.
+
+To specify multiple static MAC addresses per <<container|pod>>, set multiple networks using the **--network** option with a static MAC address specified for each using the `mac` mode for that option.