Skip to content

Commit

Permalink
docs: recommend disabling ipv6 (#390)
Browse files Browse the repository at this point in the history
* docs: recommend disabling ipv6

* docs: add example commands for disabling ipv6

* docs: remove extra command

* docs: recommend disabling via vps setup option rather than os
  • Loading branch information
thephez authored Sep 4, 2024
1 parent 1f53c3c commit 1fe14c5
Showing 1 changed file with 37 additions and 3 deletions.
40 changes: 37 additions & 3 deletions docs/user/masternodes/server-config.rst
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,12 @@ While running a masternode from home on a desktop computer is technically
possible, it will most likely not work reliably because most ISPs allocate
dynamic IP addresses to home users.

.. attention::

Disabling IPv6 is highly recommended to prevent communication issues that have been observed when
running nodes on some VPS providers. We recommend turning it off through the VPS provider's setup
wizard during initial server creation.

Before beginning, take a few minutes to review the masternode and evonode
:hoverxref:`hardware requirements <mn-hardware-reqs>` which may help you decide
which VPS provider best suits your needs. We will use `Vultr
Expand Down Expand Up @@ -172,6 +178,37 @@ repository::
The system will show a list of upgradable packages. Press **Y** and **Enter** to
install the packages.

Disable IPv6
------------

We recommend turning off IPv6 to avoid potential communication issues. If you cannot do this through
your VPS provider's server configuration settings, use the following steps to disable it through the
operating system.

Check if IPv6 is enabled::

ip a | grep inet6

If multiple inet6 entries are returned, open sysctrl.conf::

sudo nano /etc/sysctl.conf


Add the following lines at the end of the file, then press **Ctrl + X** to close the editor, then
**Y** and **Enter** save the file.::

net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1

Load the changes::

sudo sysctl -p

Finally, check if IPv6 was successfully disabled. No entries should be returned when you run the
command this time::
ip a | grep inet6

Configure the firewall
----------------------
Expand All @@ -190,7 +227,6 @@ masternode will support:

.. code-block:: shell
ufw allow ssh/tcp
ufw limit ssh/tcp
ufw allow 9999/tcp
ufw logging on
Expand All @@ -200,7 +236,6 @@ masternode will support:

.. code-block:: shell
ufw allow ssh/tcp
ufw limit ssh/tcp
ufw allow 443/tcp
ufw allow 9999/tcp
Expand All @@ -214,7 +249,6 @@ masternode will support:

.. code-block:: shell
ufw allow ssh/tcp
ufw limit ssh/tcp
ufw allow 1443/tcp
ufw allow 19999/tcp
Expand Down

0 comments on commit 1fe14c5

Please sign in to comment.