From 2655bc07ae4143bc85d34388b5fd41c56270bed5 Mon Sep 17 00:00:00 2001
From: Foxlet <foxlet@furcode.co>
Date: Mon, 22 Apr 2019 03:35:04 -0400
Subject: [PATCH] Create guide-networking.md

---
 guide-networking.md | 46 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 guide-networking.md

diff --git a/guide-networking.md b/guide-networking.md
new file mode 100644
index 0000000..5caa36c
--- /dev/null
+++ b/guide-networking.md
@@ -0,0 +1,46 @@
+Guide to Bridged Networking
+===========================
+To set up bridged networking for the macOS VM, use one of the following methods:
+
+
+## Using /etc/network/interfaces
+
+It is possible to create the bridge and tun/tap interfaces using adding the following lines to `/etc/network/interfaces`. Replace `DEVICENAME` with your ethernet card's device name, and `MYUSERNAME` with the user that is starting the VM.
+
+```
+auto br0
+iface br0 inet dhcp
+  bridge_ports DEVICENAME tap0
+
+auto tap0
+iface tap0 inet dhcp
+  pre-up tunctl -u MYUSERNAME -t tap0
+```
+
+## Using NetworkManager
+You can use NetworkManager to control the bridge and tun/tap interfaces, by creating them with the following commands. Replace `DEVICENAME` with your ethernet card's device name.
+
+### Make the Bridge
+```
+nmcli connection add type bridge \
+    ifname br1 con-name mybridge
+```
+
+### Attach Bridge to Ethernet
+```
+nmcli connection add type bridge-slave \
+    ifname DEVICENAME con-name mynetwork master br1
+```
+
+### Make the Tun/Tap
+```
+nmcli connection add type tun \
+    ifname tap0 con-name mytap \
+    mode tap owner `id -u`
+```
+
+### Attach Tun/Tap to Bridge
+```
+nmcli connection mod mytap connection.slave-type bridge \
+    connection.master br1
+```