0
0
mirror of https://github.com/netdata/netdata.git synced 2024-11-23 08:07:44 +00:00
netdata_netdata/packaging/installer/methods/no_ipv4.md
Fotis Voutsas a4201c88dc
Installation section simplification (#18911)
Co-authored-by: ilyam8 <ilya@netdata.cloud>
2024-11-04 11:18:34 +02:00

1.6 KiB
Raw Permalink Blame History

Installing on hosts without IPv4 connectivity

Our regular installation process requires access to a number of GitHub services that do not have IPv6 connectivity.

As such, using the kickstart install script on such hosts generally does not work, and will typically fail with an error from cURL or wget about connection timeouts.

You can check if your system is affected by this by attempting to connect to (or ping) https://api.github.com/. Failing to connect indicates that this issue affects you.

There are three potential workarounds for this:

  1. You can configure your system with a proper IPv6 transition mechanism, such as NAT64. GitHubs anachronisms affect many projects other than just Netdata. There are, unfortunately, a number of other services out there that do not provide IPv6 connectivity, so taking this route is likely to save you time in the future as well.
  2. If you are using a system that we publish native packages for (see our platform support policy for more details), you can manually set up our native package repositories as outlined in our native package install documentation. Our official package repositories do provide service over IPv6, so they work without issue on hosts without IPv4 connectivity.
  3. If neither of the above options work for you, you can still install using our offline installation instructions, though do note that the offline install source must be prepared from a system with IPv4 connectivity.