Overview

From version 6.0.0, Artifactory supports IPv6-enabled hosts. IPv6 support allows users to configure an IPv6 context.url in the ha-node.properties, which serves as the address used to connect an Artifactory node to its peers over REST or TCP when required. 


The following guidelines apply when configuring IPv6:

  •  IPv6 addresses should be enclosed within square brackets, regardless of whether or not an explicit port is specified.
  • The context.url parameter is the only place that requires specifying an explicit IP address rather than a DNS hostname (unless the hazelcast.interface property is also used).
  • Artifactory does not support setting an Artifactory “Base URL” that contains an explicit IPv6 address, nor does it support specifying remote server URLs (where available) or authentication providers (LDAP server / SAML server, etc) that contain IPv6 addresses.
  • Artifactory is compatible with hostnames that resolve to either IPv6 or IPv4 addresses.

    The following example shows how an IPv6 address can be used to configure an IPv6 address for the context.url parameter:

    context.url=http://[5a01::b011:81c:c101]:8081/artifactory

    Or, alternatively, if you need to use a DNS host name for the context.url for whatever reason, use the following system property in addition to the context.url:

    hazelcast.interface=[5a01::b011:81c:c101]

    Note that in HA, with Hazelcast enabled (this is the default configuration), the following parameter is required for Hazelcast to be able to bind to an IPv6 enabled interface (add this to the $ARTIFACTORY_HOME/etc/artifactory.system.properties file):

    hazelcast.prefer.ipv4.stack=false

    Note: The Replicator and Access Federation are not supported to work over IPv6. Support for this will be added in forthcoming releases.