Restructured Documentation

2026-09-05 14:08:43 -06:00
parent c4bd235eba
commit 289769a601
281 changed files with 5403 additions and 3563 deletions
@@ -0,0 +1,31 @@
+---
+tags:
+  - Docker
+  - Macvlan
+  - Networking
+---
+
+## Purpose
+You may find that you only have one network adapter on a server / VM and need to have multiple virtual networks associated with it.  For example, Home Assistant exists on the `192.168.3.0/24` network but it needs to also access devices on the `192.168.4.0/24` surveillance network.  To facilitate this, we will make a MACVLAN Sub-Interface.  This will make a virtual interface that is parented to the actual physical interface.
+
+!!! info "Assumptions"
+    It is assumed that you are running Rocky Linux (or CentOS / RedHat).
+
+## Create the Permanent Sub-Interface
+You will begin with making a new interface, it will have the name `macvlan0`.
+
+```sh
+nmcli connection add type macvlan ifname surveillance dev ens18 mode bridge ipv4.method manual ipv4.addresses 192.168.4.100/24
+nmcli connection up macvlan-surveillance
+nmcli connection show
+```
+
+## Bind a Docker Network to the Sub-Interface
+Now you need to run the following command to allow docker to use this interface for the `surveillance_network`
+
+```sh
+docker network create -d macvlan --subnet=192.168.4.0/24 --gateway=192.168.4.1 -o parent=surveillance surveillance_network
+```
+
+## Related Documentation
+- [Related Containers Documentation](<../../../reference/Containers/index.md>) — Find the connected deployments, procedures, and references for this subject.