Whisperers as standalone Docker Containers

Whisperers may be run as standalone Docker Containers.

Command

In this case, you need to have Docker (or an alternative) running in your server, and you launch a Whisperer with one command line, attaching the host network interface to it.

docker run -d \
  --network host \
  --restart unless-stopped \
  -e "CONFIG=""$(cat ./whisperer-config.json)""" \
  registry.gitlab.com/spider-analyzer/public-images/whisperer

The network option tells Docker to make all network interfaces accessible to the Whisperer container.
The -e loads the Whisperer config file from a local file ./whisperer-config.json (adjust it to your needs) into CONFIG environment variable.

Refer to official Docker run reference documentation for more options.

tip

You may include this command in a shell script and have it restart

Whisperer options

Options may be defined from environment variables:

Name (*: mandatory)	Description	Default
CONFIG *	JSON configuration value for the Whisperer. May also be mounted as ./whisperer-config.json in the container.
LOG	When HUMAN, logs will be formatted by Bunyan library for better reading with colors etc.
LOG_LEVEL	Define the log level. May be FATAL, ERROR, WARN, INFO, DEBUG, TRACE	INFO
HOSTNAME or PARENT_HOSTNAME	Sent back to the server in the hostname field of status. Used for proper identification in the UI.
INSTANCE_ID	Used to differentiate replicas of a same Whisperer. Must be unique by Whisperer.	os.hostname()
CONTAINER_NAME	Sent back to the server in the containeName field of status. Used for proper identification in the UI.
HOSTS_TO_RESOLVE	May provide a list of '\n' separated hostnames to resolve and load in cache before starting parsing.
DNSCACHE_HOST	Used to force a DNS server. Even to connect to Spider server. Specifies its hostname or IP.
DNSCACHE_PORT	Used to force a DNS server. Even to connect to Spider server. Specifies its port.	53
CAPTURE_OWN_COMS	If set - whatever value that resolve to true -, the Whisperer will also capture its communications to Spider. DANGEROUS!