Deprecated Backend ENVs
This table is horizontally scrollable, version information is located in the last column.
ETHEREUM_JSONRPC_JSON_RPC_TRANSPORT
Specifies the transport for blockscout to connect to the Ethereum Node. Available transports are http and ipc. If ipc is selected, also set IPC_PATH variable. Replaced with ETHEREUM_JSONRPC_TRANSPORT
http
v2.1.1+
v3.1.0
COINMARKETCAP_PAGES
the number of pages on coinmarketcap to list in order to find token's price
10
v1.3.10+
v2.0.4
COIN_GECKO_ID
CoinGecko coin id required for fetching an exchange rate
poa-network
v2.0.4+
v2.1.0+
NETWORK_ICON
Environment variable for the main network icon or testnet icon. Two options are _test_network_icon.html and _network_icon.html
_network_icon.html
All
v2.0.0+
REWARDS_CONTRACT_ADDRESS
Emission rewards contract address. This env var is used only if EMISSION_FORMAT is set to POA . Replaced with REWARDS_CONTRACT
0xeca443e8e1ab29971a45a9c57a6a9875701698a5
v2.0.4+
v3.1.0
OMNI_BRIDGE_MEDIATOR
An address of home OmniBridge mediator to bridge multiple tokens from Ethereum. Providing this address enables bridged tokens functionality: bridged status and link to the original token in the foreign chain.
(empty)
v3.3.2+
v3.6.0
ENABLE_1559_SUPPORT
false
v4.0.0+
v4.1.0
BLOCK_COUNT_CACHE_PERIOD
2 hours
v2.0.0+
v4.1.3
TXS_COUNT_CACHE_PERIOD
Interval in seconds to restart the task, which calculates the total txs count.
2 hours
v1.3.9+
v4.1.3
ADDRESS_COUNT_CACHE_PERIOD
2 hours
v2.1.1+
v4.1.3
ADDRESS_SUM_CACHE_PERIOD
1 hour
v2.1.1+
v4.1.3
TOTAL_GAS_USAGE_CACHE_PERIOD
Interval in seconds to restart the task, which calculates the total gas usage.
2 hours
v3.4.0+
v4.1.3
ADDRESS_TRANSACTIONS_GAS_USAGE_COUNTER_CACHE_PERIOD
Interval in seconds to restart the task, which calculates gas usage at the address.
30 minutes
v3.4.0+
v4.1.3
TOKEN_HOLDERS_COUNTER_CACHE_PERIOD
Interval in seconds to restart the task, which calculates holders count of the token.
1 hour
v3.4.0+
v4.1.3
TOKEN_TRANSFERS_COUNTER_CACHE_PERIOD
Interval in seconds to restart the task, which calculates transfers count of the token.
1 hour
v3.4.0+
v4.1.3
ADDRESS_WITH_BALANCES_UPDATE_INTERVAL
Interval in seconds to restart the task, which calculates addresses with balances.
30 minutes
v1.3.9+
v4.1.3
AVERAGE_BLOCK_CACHE_PERIOD
Update of average block period cache, in seconds
30 minutes
v2.0.2+
v4.1.3
MARKET_HISTORY_CACHE_PERIOD
Update of market history cache, in seconds
6 hours
v2.0.2+
v4.1.3
COINGECKO_COIN_ID
Explicitly set CoinGecko coin ID
(empty)
v3.1.2+
v4.1.4
SOURCE_MODULE
This environment variable is used to calculate the exchange rate and is specifically used by the xDai Chain. Available value is TokenBridge
(empty)
v1.0.0+
v4.1.4
POS_STAKING_CONTRACT
The address of POSDAO staking contract. When provided, enables staking DApp. ValidatorSet and BlockReward contract addresses are fetched using corresponding getters.
(empty)
v3.4.0+
v4.1.x
POS_ETH_SUBSCRIBE_MAX_DELAY
Used by the staking DApp. The number of seconds of max delay after the latest block number arrived from eth_subscribe. Once this time is elapsed, the staking DApp automatically switches to eth_blockNumber which then is requested every POS_ETH_BLOCKNUMBER_PULL_INTERVAL milliseconds until eth_subscribe works again.
60
v3.6.0+
v4.1.x
POS_ETH_BLOCKNUMBER_PULL_INTERVAL
An interval between eth_blockNumber requests (in milliseconds) made by staking DApp to retrieve a new block number. Used when eth_subscribe stops working.
500
v3.6.0+
v4.1.x
ENABLE_POS_STAKING_IN_MENU
Enables Staking dapp in the menu
false
v3.6.0+
v4.1.x
SHOW_STAKING_WARNING
Disables/enables announcement inside staking dapp
false
v3.6.0+
v4.1.x
STAKING_WARNING_MESSAGE
Message text of the announcement inside staking dapp
(empty)
v3.6.0+
v4.1.x
ETH_OMNI_BRIDGE_MEDIATOR
An address of home OmniBridge mediator to bridge multiple tokens from Ethereum. Providing this address enables bridged tokens functionality: bridged status and link to the original token in the foreign chain.
(empty)
v3.6.0+
v4.1.x
BSC_OMNI_BRIDGE_MEDIATOR
An address of home OmniBridge mediator to bridge multiple tokens from Binance Smart Chain. Providing this address enables bridged tokens functionality: bridged status and link to the original token in the foreign chain.
(empty)
v3.6.0+
v4.1.x
AMB_BRIDGE_MEDIATORS
A comma-separated list of AMB extensions' mediators' addresses' hashes to fetch bridged tokens through those mediators.
(empty)
v3.6.0+
v4.1.x
FOREIGN_JSON_RPC
(empty)
v3.3.3+
v4.1.x
BRIDGE_MARKET_CAP_UPDATE_INTERVAL
30 minutes
v3.3.3+
v4.1.x
DISABLE_BRIDGE_MARKET_CAP_UPDATER
Disables recurring consolidation of TokenBridge market cap from TokenBridge, OmniBridge and AMB extensions
(empty)
v3.3.3+
v4.1.x
EXTERNAL_APPS
(empty)
v3.3.1+
v5.0.0
API_PATH
PATH in API endpoint URL at API docs page.
/
v3.1.0+
✅
v5.1.1
SOCKET_ROOT
Custom websocket path.
(empty)
v3.0.0+
✅
v5.1.1
MAX_SIZE_UNLESS_HIDE_ARRAY
50
v3.7.1+
v5.1.2
ALLOWED_EVM_VERSIONS
"homestead, tangerineWhistle, spuriousDragon, byzantium, constantinople, petersburg,istanbul"
v2.0.0+
v5.1.2
DISABLE_KNOWN_TOKENS
Disables or enables token symbol for known contract.
false
v3.4.0+
v5.1.2
TOKEN_BALANCE_ON_DEMAND_FETCHER_THRESHOLD_MINUTES
60 minutes
v3.7.1+
v5.1.2
COIN_BALANCE_ON_DEMAND_FETCHER_THRESHOLD_MINUTES
60 minutes
v4.1.2+
v5.1.2
CUSTOM_CONTRACT_ADDRESSES_TEST_TOKEN
List of test tokens addresses: test label will be applied and those tokens will be excluded from omni bridge market cap calculation.
(empty)
v3.6.0+
v5.1.2
CACHE_TOKEN_EXCHANGE_RATE_PERIOD
Managing cache invalidation for token's exchange rate.
1 hour
v3.5.0+
v5.1.2
INDEXER_DISABLE_EMPTY_BLOCK_SANITIZER
Empty blocks sanitizer is disabled if true
false
v4.1.3+
v5.1.2
HISTORY_FETCH_INTERVAL
1h
v3.1.2+
v5.1.3
WOBSERVER_ENABLED
If true enables wobserver interface.
(empty)
v3.3.2+
v5.1.3
VISUALIZE_SOL2UML_ENABLED
(empty)
v5.0.0+
v5.1.3
VISUALIZE_SOL2UML_SERVICE_URL
(empty)
v5.0.0+
v5.1.3
SIG_PROVIDER_SERVICE_URL
(empty)
v5.1.0+
v5.1.3
SIG_PROVIDER_ENABLED
(empty)
v5.1.0+
v5.1.3
ENABLE_RUST_VERIFICATION_SERVICE
(empty)
v4.1.8+
v5.1.3
RUST_VERIFICATION_SERVICE_URL
(empty)
v4.1.8+
v5.1.3
LINK_TO_OTHER_EXPLORERS
true/false. If true, links to other explorers are added in the footer.
(empty)
v1.3.0+
v5.1.3
OTHER_EXPLORERS
(empty)
v3.4.0+
v5.1.3
FOOTER_ENABLE_FORUM_LINK
false
v5.0.0+
v5.1.3
ENABLE_SOURCIFY_INTEGRATION
Enables or disables verification of contracts through Sourcify.
false
v3.7.0+
v5.1.3
ENABLE_TXS_STATS
Disables or enables txs per day stats gathering.
true
v3.1.2+
v5.1.3
CACHE_ENABLE_TOTAL_GAS_USAGE_COUNTER
if true, enables cache for total gas usage counter.
false
v5.1.2+
v5.1.3
LOGO_FOOTER
/images/blockscout_logo.svg
v5.1.3
INDEXER_TOKEN_INSTANCE_CONCURRENCY
10
v5.1.2+
v5.1.4
INDEXER_TOKEN_INSTANCE_BATCH_SIZE
1
v5.1.2+
v5.1.4
DISABLE_TOKEN_INSTANCE_FETCHER
If true, token instance fetcher doesn't run
false
v5.0.0+
v5.1.4
ACCOUNT_AUTH0_LOGOUT_URL
(empty)
v5.0.0+
v5.1.4
ACCOUNT_AUTH0_LOGOUT_RETURN_URL
(empty)
v5.0.0+
v5.1.4
ACCOUNT_AUTHENTICATE_ENDPOINT_API_KEY
(empty)
v5.1.2+
v5.1.5+
DISABLE_READ_API
If true, read-only endpoints to API are hidden (compile-time).
false
v2.0.3+
✅
v5.1.5
DISABLE_WRITE_API
If true, write endpoints to API are hidden (compile-time).
false
v2.0.3+
✅
v5.1.5
CONTRACT_VERIFICATION_ALLOWED_EVM_VERSIONS
"homestead, tangerineWhistle, spuriousDragon, byzantium, constantinople, petersburg,istanbul"
v2.0.0+
v5.2.0
EXCHANGE_RATES_SOURCE
This environment variable is used to calculate the exchange rates. Available value is token_bridge. Available values are also coin_gecko and coin_market_cap.
(empty)
v4.1.4+
v5.2.3
INDEXER_ZKEVM_BATCHES_ENABLED
false
v5.3.1+
v6.2.0
INDEXER_ZKEVM_BATCHES_CHUNK_SIZE
20
v5.3.1+
v6.2.0
INDEXER_ZKEVM_BATCHES_RECHECK_INTERVAL
60
v5.3.1+
v6.2.0
GRAPHIQL_TRANSACTION
Default transaction hash in a sample query to GraphiQL.
(empty)
v1.2.0+
✅
v6.4.0
INDEXER_TOKEN_INSTANCE_RETRY_REFETCH_INTERVAL
24h
v5.1.4+
v6.6.0
INDEXER_INTERNAL_TRANSACTIONS_INDEXING_FINISHED_THRESHOLD
1000
v5.2.0+
v6.6.0
INDEXER_OPTIMISM_L1_DEPOSITS_START_BLOCK
(empty)
v6.3.0+
v6.8.0
INDEXER_OPTIMISM_L1_WITHDRAWALS_START_BLOCK
(empty)
v6.3.0+
v6.8.0
INDEXER_OPTIMISM_L1_OUTPUT_ROOTS_START_BLOCK
(empty)
v6.3.0+
v6.8.0
INDEXER_OPTIMISM_L1_BATCH_START_BLOCK
(empty)
v6.3.0+
v6.8.0
INDEXER_OPTIMISM_L1_DEPOSITS_BATCH_SIZE
500
v6.3.0+
v6.8.0
METRICS_DISABLE_PUBLIC
false
v6.7.2+
v6.8.0
RESTRICTED_LIST
A comma-separated list of addresses to enable restricted access to them.
(empty)
v3.3.3+
v6.10.0
RESTRICTED_LIST_KEY
A key to access addresses listed inRESTRICTED_LIST variable. Can be passed via query param to the page's URL: ?key=...
(empty)
v3.3.3+
v6.10.0
Last updated