Skip to content

static-map.mdx

Latest commit

 

History

History
51 lines (32 loc) · 1.37 KB

static-map.mdx

File metadata and controls

51 lines (32 loc) · 1.37 KB
sidebar_position 3
description Configure the behavior of hostnames and DNS resolution in the static_host_map.

import { Pill } from '@components/Pill/Pill';

static_map

The static map defines options which control the interpretation of the static_host_map.

Example:

static_map:
  network: ip4
  cadence: 30s
  lookup_timeout: 250ms

static_map.network

Default: ip4

Select the IP version used to communicate with hosts in the static map. Valid values are ip4, ip6, and ip (for both.)

:::warning

In general, this should be left as the default value ip4 to avoid issues communicating with IPv4-only hosts.

Lighthouses learn each node's IP addresses by looking at the source address of incoming packets as well as the self-reported addresses sent by the node. Because most devices are behind a NAT of some sort (e.g. a network router) they cannot self-report their public IPv4 address. By contacting the lighthouse via its IPv4 address, the lighthouse is able to learn the node's public IPv4 address.

It is necessary to set this setting to ip6 (or ip) for IPv6-only hosts.

:::

static_map.cadence

Default: 30s

Interval to re-query DNS for hostnames listed in the static map

static_map.lookup_timeout

Default: 250ms

Timeout for DNS lookup of static hosts