Fabric8 Documentation

Environment variables

Fabric8 supports a number of environment variables which make it easy to configure how a container starts up. The various options are

  • create a new local fabric on startup (the default)
  • join an existing fabric
  • startup in stand alone mode (no fabric)

The use of environment variables is particularly useful for when you are using Fabric8 with some kind of cloud technologies like Docker, OpenShift, OpenStack, EC2 etc.

i.e. you can use the same distribution, docker container image or virtual machine image and change how you wish the container to behave just via environment variables.

Variables reference

Environment Variable Description
FABRIC8_ENSEMBLE_AUTO_START Value is 'true' or 'false' depending on if the container should auto-start an ensemble.
FABRIC8_AGENT_AUTO_START Value is 'true' or 'false' depending on if the container should auto-start the fabric8 agent.
FABRIC8_ZOOKEEPER_URL The URL of the ZooKeeper server(s) to connect to on startup; when joining a fabric on startup. e.g. hostname:2181
FABRIC8_ZOOKEEPER_PASSWORD The password used when automatically creating a fabric on startup.
FABRIC8_PROFILES The initial profiles to add to a newly created fabric.
FABRIC8_GLOBAL_RESOLVER Whether to use manualip, localip or localhostname to resolve names.
FABRIC8_MANUALIP What IP address should be used if the 'manualip' resolver is used (see above).
FABRIC8_BINDADDRESS What network address should the container bind to.
FABRIC8_RUNTIME_ID The default container name to use.
FABRIC8_KARAF_NAME The default container name to use (now deprecated, please use FABRIC8_RUNTIME_ID instead).