Skip to content

Commit 1fe14c5

Browse files
authored
docs: recommend disabling ipv6 (#390)
* 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
1 parent 1f53c3c commit 1fe14c5

File tree

1 file changed

+37
-3
lines changed

1 file changed

+37
-3
lines changed

docs/user/masternodes/server-config.rst

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,12 @@ While running a masternode from home on a desktop computer is technically
3838
possible, it will most likely not work reliably because most ISPs allocate
3939
dynamic IP addresses to home users.
4040

41+
.. attention::
42+
43+
Disabling IPv6 is highly recommended to prevent communication issues that have been observed when
44+
running nodes on some VPS providers. We recommend turning it off through the VPS provider's setup
45+
wizard during initial server creation.
46+
4147
Before beginning, take a few minutes to review the masternode and evonode
4248
:hoverxref:`hardware requirements <mn-hardware-reqs>` which may help you decide
4349
which VPS provider best suits your needs. We will use `Vultr
@@ -172,6 +178,37 @@ repository::
172178
The system will show a list of upgradable packages. Press **Y** and **Enter** to
173179
install the packages.
174180

181+
Disable IPv6
182+
------------
183+
184+
We recommend turning off IPv6 to avoid potential communication issues. If you cannot do this through
185+
your VPS provider's server configuration settings, use the following steps to disable it through the
186+
operating system.
187+
188+
Check if IPv6 is enabled::
189+
190+
ip a | grep inet6
191+
192+
If multiple inet6 entries are returned, open sysctrl.conf::
193+
194+
sudo nano /etc/sysctl.conf
195+
196+
197+
Add the following lines at the end of the file, then press **Ctrl + X** to close the editor, then
198+
**Y** and **Enter** save the file.::
199+
200+
net.ipv6.conf.all.disable_ipv6 = 1
201+
net.ipv6.conf.default.disable_ipv6 = 1
202+
net.ipv6.conf.lo.disable_ipv6 = 1
203+
204+
Load the changes::
205+
206+
sudo sysctl -p
207+
208+
Finally, check if IPv6 was successfully disabled. No entries should be returned when you run the
209+
command this time::
210+
211+
ip a | grep inet6
175212

176213
Configure the firewall
177214
----------------------
@@ -190,7 +227,6 @@ masternode will support:
190227

191228
.. code-block:: shell
192229
193-
ufw allow ssh/tcp
194230
ufw limit ssh/tcp
195231
ufw allow 9999/tcp
196232
ufw logging on
@@ -200,7 +236,6 @@ masternode will support:
200236

201237
.. code-block:: shell
202238
203-
ufw allow ssh/tcp
204239
ufw limit ssh/tcp
205240
ufw allow 443/tcp
206241
ufw allow 9999/tcp
@@ -214,7 +249,6 @@ masternode will support:
214249

215250
.. code-block:: shell
216251
217-
ufw allow ssh/tcp
218252
ufw limit ssh/tcp
219253
ufw allow 1443/tcp
220254
ufw allow 19999/tcp

0 commit comments

Comments
 (0)