summaryrefslogtreecommitdiff
path: root/docs/appendix
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2020-01-23 06:36:06 +0100
committerChristian Poessinger <christian@poessinger.com>2020-01-23 06:36:06 +0100
commitfad3736ed15cad27098ce476dd5f55e0b612abb2 (patch)
treea75bb5369eb778f39ee28485b618702b9319f38b /docs/appendix
parentef2e6b23c543f93199e192ea8d1c442252a75f3b (diff)
downloadvyos-documentation-fad3736ed15cad27098ce476dd5f55e0b612abb2.tar.gz
vyos-documentation-fad3736ed15cad27098ce476dd5f55e0b612abb2.zip
appendix: tunnelbroker: use documented section style guide
Diffstat (limited to 'docs/appendix')
-rw-r--r--docs/appendix/examples/tunnelbroker-ipv6.rst19
1 files changed, 10 insertions, 9 deletions
diff --git a/docs/appendix/examples/tunnelbroker-ipv6.rst b/docs/appendix/examples/tunnelbroker-ipv6.rst
index 2977604d..0e62b051 100644
--- a/docs/appendix/examples/tunnelbroker-ipv6.rst
+++ b/docs/appendix/examples/tunnelbroker-ipv6.rst
@@ -1,19 +1,20 @@
.. _examples-tunnelbroker-ipv6:
-VyOS Tunnelbroker.net IPv6
---------------------------
+#######################
+Tunnelbroker.net (IPv6)
+#######################
This guides walks through the setup of `Tunnelbroker.net <https://www.tunnelbroker.net/>`_ for an IPv6 Tunnel.
Prerequisites
-^^^^^^^^^^^^^
+=============
- A public IP address. This does not necessarily need to be static, but you will need to update the tunnel endpoint when/if your IP address changes, which can be done with a script and a scheduled task.
- An account at `Tunnelbroker.net <https://www.tunnelbroker.net/>`_.
- Requested a "Regular Tunnel". You want to choose a location that is closest to your physical location for the best response time.
-Setting up the initial tunnel
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Setup initial tunnel
+====================
- Set up the initial IPv6 tunnel. Replace the field below from the fields on the `Tunnelbroker.net <https://www.tunnelbroker.net/>`_ tunnel information page.
@@ -71,7 +72,7 @@ Setting up the initial tunnel
- Assuming everything works, you can proceed to client configuration
LAN Configuration
-^^^^^^^^^^^^^^^^^
+=================
At this point your VyOS install should have full IPv6, but now your LAN devices need access.
@@ -83,7 +84,7 @@ With Tunnelbroker.net, you have two options:
Unlike IPv4, IPv6 is really not designed to be broken up smaller than /64. So if you ever want to have multiple LANs, VLANs, DMZ, etc, you'll want to ignore the assigned /64, and request the /48 and use that.
Single LAN Setup
-^^^^^^^^^^^^^^^^
+================
Single LAN setup where eth1 is your LAN interface. Use the /64 (all the xxxx should be replaced with the information from your `Routed /64` tunnel):
@@ -103,7 +104,7 @@ Single LAN setup where eth1 is your LAN interface. Use the /64 (all the xxxx sh
- Enables router advertisements. This is an IPv6 alternative for DHCP (though DHCPv6 can still be used). With RAs, Your devices will automatically find the information they need for routing and DNS.
Multiple LAN/DMZ Setup
-^^^^^^^^^^^^^^^^^^^^^^
+======================
In this, you use the `Routed /48` information. This allows you to assign a different /64 to every interface, LAN, or even device. Or you could break your network into smaller chunks like /56 or /60.
@@ -142,7 +143,7 @@ So, when your LAN is eth1, your DMZ is eth2, your cameras live on eth3, etc:
set interfaces ethernet eth3 ipv6 router-advert prefix 2001:470:xxxx:3::/64 valid-lifetime '2592000'
Firewall
-^^^^^^^^
+========
Finally, don't forget the :ref:`firewall`. The usage is identical, except for instead of `set firewall name NAME`, you would use `set firewall ipv6-name NAME`.