configuration.md

description	keywords
This section describes the configuration parameters and their types for INX-Faucet.	IOTA Node Hornet Node Faucet Configuration JSON Customize Config reference

Core Configuration

INX-Faucet uses a JSON standard format as a config file. If you are unsure about JSON syntax, you can find more information in the official JSON specs.

You can change the path of the config file by using the -c or --config argument while executing inx-faucet executable.

For example:

inx-faucet -c config_defaults.json

You can always get the most up-to-date description of the config parameters by running:

inx-faucet -h --full

1. Application

Name	Description	Type	Default value
checkForUpdates	Whether to check for updates of the application or not	boolean	true
shutdown	Configuration for shutdown	object

Shutdown

Name	Description	Type	Default value
stopGracePeriod	The maximum time to wait for background processes to finish during shutdown before terminating the app	string	"5m"
log	Configuration for log	object

Log

Name	Description	Type	Default value
enabled	Whether to store self-shutdown events to a log file	boolean	true
filePath	The file path to the self-shutdown log	string	"shutdown.log"

Example:

  {
    "app": {
      "checkForUpdates": true,
      "shutdown": {
        "stopGracePeriod": "5m",
        "log": {
          "enabled": true,
          "filePath": "shutdown.log"
        }
      }
    }
  }

2. Logger

Name	Description	Type	Default value
name	The optional name of the logger instance. All log messages are prefixed with that name.	string	""
level	The minimum enabled logging level	string	"info"
timeFormat	Sets the logger's timestamp format. (options: "rfc3339", "rfc3339nano", "datetime", "timeonly", and "iso8601")	string	"rfc3339"
outputPaths	A list of file paths or stdout/stderr to write logging output to	array	stdout

Example:

  {
    "logger": {
      "name": "",
      "level": "info",
      "timeFormat": "rfc3339",
      "outputPaths": [
        "stdout"
      ]
    }
  }

3. INX

Name	Description	Type	Default value
address	The INX address to which to connect to	string	"localhost:9029"
maxConnectionAttempts	The amount of times the connection to INX will be attempted before it fails (1 attempt per second)	uint	30
targetNetworkName	The network name on which the node should operate on (optional)	string	""

Example:

  {
    "inx": {
      "address": "localhost:9029",
      "maxConnectionAttempts": 30,
      "targetNetworkName": ""
    }
  }

4. Faucet

Name	Description	Type	Default value
baseTokenAmount	The amount of funds the requester receives	uint	1000000000
baseTokenAmountSmall	The amount of funds the requester receives if the target address has more funds than the faucet amount and less than maximum	uint	100000000
baseTokenAmountMaxTarget	The maximum allowed amount of funds on the target address	uint	5000000000
manaAmount	The amount of mana the requester receives	uint	1000000
manaAmountMinFaucet	The minimum amount of mana the faucet needs to hold before mana payouts become active	uint	1000000000
tagMessage	The faucet transaction tag payload	string	"FAUCET"
batchTimeout	The maximum duration for collecting faucet batches	string	"2s"
bindAddress	The bind address on which the faucet website can be accessed from	string	"localhost:8091"
rateLimit	Configuration for rateLimit	object
pow	Configuration for pow	object
debugRequestLoggerEnabled	Whether the debug logging for requests should be enabled	boolean	false

RateLimit

Name	Description	Type	Default value
enabled	Whether the rate limiting should be enabled	boolean	true
period	The period for rate limiting	string	"5m"
maxRequests	The maximum number of requests per period	int	10
maxBurst	Additional requests allowed in the burst period	int	20

Pow

Name	Description	Type	Default value
workerCount	The amount of workers used for calculating PoW when sending payloads to the block issuer	int	4

Example:

  {
    "faucet": {
      "baseTokenAmount": 1000000000,
      "baseTokenAmountSmall": 100000000,
      "baseTokenAmountMaxTarget": 5000000000,
      "manaAmount": 1000000,
      "manaAmountMinFaucet": 1000000000,
      "tagMessage": "FAUCET",
      "batchTimeout": "2s",
      "bindAddress": "localhost:8091",
      "rateLimit": {
        "enabled": true,
        "period": "5m",
        "maxRequests": 10,
        "maxBurst": 20
      },
      "pow": {
        "workerCount": 4
      },
      "debugRequestLoggerEnabled": false
    }
  }

5. Profiling

Name	Description	Type	Default value
enabled	Whether the profiling component is enabled	boolean	false
bindAddress	The bind address on which the profiler listens on	string	"localhost:6060"

Example:

  {
    "profiling": {
      "enabled": false,
      "bindAddress": "localhost:6060"
    }
  }