summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/configuration/system/host-name.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/configuration/system/host-name.rst b/docs/configuration/system/host-name.rst
index 6b3a075f..6915af15 100644
--- a/docs/configuration/system/host-name.rst
+++ b/docs/configuration/system/host-name.rst
@@ -49,6 +49,10 @@ This section shows how to statically map an IP address to a hostname for local
(meaning on this VyOS instance) name resolution. This is the VyOS equivalent to
`/etc/hosts` file entries.
+.. note:: Do *not* manually edit `/etc/hosts`. This file will automatically be
+regenerated on boot based on the settings in this section, which means you'll
+lose all your manual edits. Instead, configure static host mappings, as follows.
+
.. cfgcmd:: set system static-host-mapping host-name <hostname> inet <address>
Create a static hostname mapping which will always resolve the name