diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index 00c14eafeb..e4373ba691 100644
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -614,6 +614,16 @@
Note that is the default if the
systemd-nspawn@.service template unit file is used.
+
+ Note that on Linux network interface names may have a length of 15 characters at maximum, while
+ container names may have a length up to 64 characters. As this option derives the host-side interface
+ name from the container name the name is possibly truncated. Thus, care needs to be taken to ensure
+ that interface names remain unique in this case, or even better container names are generally not
+ chosen longer than 12 characters, to avoid the truncation. Alternatively, the
+ option may be used, which allows free configuration of the
+ host-side interface name independently of the container name — but might require a bit more
+ additional configuration in case bridging in a fashion similar to
+ is desired.
@@ -635,11 +645,13 @@
- Adds the host side of the Ethernet link created with to the
- specified Ethernet bridge interface. Expects a valid network interface name of a bridge device as
- argument. Note that implies . If this option
- is used, the host side of the Ethernet link will use the vb- prefix instead of
- ve-.
+ Adds the host side of the Ethernet link created with
+ to the specified Ethernet bridge interface. Expects a valid network interface name of a bridge device
+ as argument. Note that implies . If
+ this option is used, the host side of the Ethernet link will use the vb- prefix
+ instead of ve-. Regardless of the used naming prefix the same network interface
+ name length limits imposed by Linux apply, along with the complications this creates (for details see
+ above).