Environmental Variables

Host for GraphQL queries. You may use any available gateway that supports GQL queries. If omitted, your node can support GQL queries on locally indexed transactions, but only L1 transactions are indexed by default.

Port for GraphQL queries. Used in conjunction with GRAPHQL_HOST to set up the proxy for GQL queries.

Starting block height for node synchronization (0 = start from genesis block)

Stop block height for node synchronization (Infinity = keep syncing until stopped)

Request timeout in milliseconds for trusted gateways

Any positive number above 0, best to keep 1 or less. Used to determine the sensitivity of which the probability of failing or succeeding peers decreases or increases.

Sets the format of output logs, accepts "simple" and "json"

If true, skips the local cache and always fetches headers from the node

Number from 0 to 1, representing the probability of a request failing

Arweave wallet address used for staking and rewards

API key used for admin API requests (if not set, it is generated and logged into the console)

Alternative way to set the API key used for admin API requests via filepath, it takes precedence over ADMIN_API_KEY if defined

If true, AR.IO node will start indexing missing bundles

If true, all indexed bundles will be reprocessed with the new filters (you can use this when you change the filters)

Data source retrieval order for on-demand data requests

Data source retrieval order for background data requests (i.e., unbundling)

Only bundles compliant with this filter will be unbundled

Only bundles compliant with this filter will be indexed

Sets the number of ANS-104 bundles to attempt to download in parallel

Sets the number of workers used to handle unbundling

Sets the number of new data items indexed before flushing to stable data items

Sets the maximum time interval in seconds before flushing to stable data items

If true, the data item signatures will be written to the database

If true, the transactions signatures will be written to the database

If true, the data database WAL cleanup worker will be enabled

If true, unverified data will be verified in background

Sets the maximum number of data items to queue for indexing before skipping indexing new data items

Protocol setting in process of creating sandbox domains in ArNS (ARNS_ROOT_HOST needs to be set for this env to have any effect) accepts "http" or "https"

If true, start indexing blocks, tx, ANS104 bundles

If true, run observer (ARIO processes), requires WALLET env var to be set

Accepts 'gzip', 'brotli', or 'none'. Compresses new blocks with specified algorithm before storing them in the local header store. Note: Changing this after blocks have been stored locally will require re-sync or remove local data to apply new compression setting to previously stored blocks.

Accepts 'gzip', 'brotli', or 'none'. Compresses new bundles with specified algorithm before storing them in the local bundle store. Note: Changing this after bundles have been stored locally will require re-indexing to apply new compression setting to previously stored bundles.

Accepts 'gzip', 'brotli', or 'none'. Compresses new data items with specified algorithm before storing them in the local data item store. Note: Changing this after data items have been stored locally will require re-indexing to apply new compression setting to previously stored data items.

Accepts 'gzip', 'brotli', or 'none'. Compresses new transactions with specified algorithm before storing them in the local transaction store. Note: Changing this after transactions have been stored locally will require re-sync or remove local data to apply new compression setting to previously stored transactions.

Accepts 'gzip', 'brotli', or 'none'. Compresses new data with specified algorithm before storing them in the local data store. Note: Changing this after data has been stored locally will require re-sync or remove local data to apply new compression setting to previously stored data.

Sets the number of contiguous data items to cache before cleaning up

If true, enable header cache cleanup for the fs cache (this will prune headers that are older than HEADER_CACHE_CLEANUP_THRESHOLD)

Sets the height threshold for which to clean up headers

Sets the number of chunks to cache before cleaning up

Sets the number of data items to cache before cleaning up manifest cache

Sets the number of data items to cache before cleaning up ANS-104 data index cache

Redis cache URL for external caching of data items, chunks, and tx headers

Minimum number of confirmations needed for a transaction to be returned by the /tx endpoint

If true, the gateway will index blocks as they're synced

If true, the gateway will index transactions as they're synced

If true, the gateway will index data items as they're synced

If true, the gateway will index the chunks of block data and transaction data offsets

If true, the gateway will watch the mempool for new transactions and save the txs headers

If true, allows the gateway to act as a client and execute webhooks when local state changes

Comma separated list of target webhook servers (URLs)

Webhook events are emitted only if incoming transactions satisfy the specified filter

Block webhook events are emitted only if incoming block satisfies the specified filter

If true, the gateway will expose Prometheus compatible metrics via the /metrics endpoint