Configuring calico/node

The calico/node container is primarily configured through environment variables.

Environment Variables

Environment

Description

Schema

Default

NODENAME

A unique identifier for this host.

string

NO_DEFAULT_POOLS

Prevents Calico from creating a default pool if one does not exist.

string

HOSTNAME [Deprecated]

The Hostname of this host. This is used as a unique identifier for the node. This value is overridden by NODENAME. When omitted, if NODENAME has not been specified, this value defaults to the actual hostname of this host.

string

IP

The IPv4 address to assign this host. When specified, the address is saved in the node resource configuration for this host, overriding any previously configured value. When omitted, if an address has been saved in the node resource, then that value will be used. When omitted, if an address has not yet been configured in the node resource, the node will auto-detect an IPv4 address and configure the node resource with that address. This autodetection can be forced (even if a value has already been set in the node resource) by setting IP to “autodetect”. Doing so will overwrite any value configured in the node resource.

ip address

IP6

The IPv6 address for Calico will bind to. When specified, the address is saved in the node resource configuration for this host, overriding any previously configured value. When omitted, if an address has not yet been configured in the node resource, IPv6 routing is not enabled. When omitted, if an IPv6 address has been previously configured in the node resource, IPv6 is enabled using the already configured address.

ipv6 address

AS

The AS number for this node. When specified, the value is saved in the node resource configuration for this host, overriding any previously configured value. When omitted, if an AS number has been previously configured in the node resource, that AS number is used for the peering. When omitted, if an AS number has not yet been configured in the node resource, the node will use the global value (managed through calicoctl config set/get asnumber).

int

global AS number

DATASTORE_TYPE

Type of datastore.

kubernetes, etcdv2

etcdv2

WAIT_FOR_DATASTORE

Wait for connection to datastore before starting. If a successful connection is not made, node will shutdown.

boolean

false

CALICO_LIBNETWORK_ENABLED

Enables running the docker-libnetwork plugin directly in the calico/node container.

boolean

true

CALICO_LIBNETWORK_IFPREFIX

Interface prefix to use for the network interface within the Docker containers that have been networked by the Calico driver.