summaryrefslogtreecommitdiff
path: root/docs/system/default-route.rst
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2019-12-20 18:09:45 +0100
committerChristian Poessinger <christian@poessinger.com>2019-12-20 18:09:45 +0100
commit2484e2f7c4044cca1694929d9ca2e2f413b3ae3c (patch)
treecd2f22c4cc81e69035758e712da538e861cfc64b /docs/system/default-route.rst
parentc046551a8bf549a232c5fd61ad99294f802d5675 (diff)
downloadvyos-documentation-2484e2f7c4044cca1694929d9ca2e2f413b3ae3c.tar.gz
vyos-documentation-2484e2f7c4044cca1694929d9ca2e2f413b3ae3c.zip
default-route: use dedicated chapter
Diffstat (limited to 'docs/system/default-route.rst')
-rw-r--r--docs/system/default-route.rst40
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/system/default-route.rst b/docs/system/default-route.rst
new file mode 100644
index 00000000..567a41c8
--- /dev/null
+++ b/docs/system/default-route.rst
@@ -0,0 +1,40 @@
+.. _default_gateway:
+
+#####################
+Default Gateway/Route
+#####################
+
+In the past (VyOS 1.1) used a gateway-address configured under the system tree
+(:cfgcmd:`set system gateway-address '<address>'`), this is no longer supported
+and existing configurations are migrated to the new CLI command.
+
+Configuration
+=============
+
+.. cfgcmd:: set protocols static route 0.0.0.0/0 next-hop '<address>'
+
+ Specify static route into the routing table sending all non local traffic
+ to the nexthop address `<address>`.
+
+
+.. cfgcmd:: delete protocols static route 0.0.0.0/0
+
+ Delete default route from the system.
+
+Operation
+=========
+
+.. opcmd:: show ip route 0.0.0.0
+
+ Show routing table entry for the default route.
+
+ .. code-block:: none
+
+ vyos@vyos:~$ show ip route 0.0.0.0
+ Routing entry for 0.0.0.0/0
+ Known via "static", distance 10, metric 0, best
+ Last update 09:46:30 ago
+ * 172.18.201.254, via eth0.201
+
+.. seealso:: Configuration of :ref:`routing-static`
+