Frontend Common ENVs

The following are common frontend variables only.

Backend ENVs are available here.

-> Full list of ENVs with example values

-> ENV File example

Below we describe information about common frontend variables, located at docker-compose/envs/common-frontend.env. For a complete list along with example values and other information, please see the full list of ENVs.

VariableStandard valueInfo

NEXT_PUBLIC_API_HOST

localhost

Host of the API backend. If you proxy the frontend and backend to the same url in the .conf file you do not need to specify a port.

NEXT_PUBLIC_API_PROTOCOL

http

If you have ssl configured use https.

NEXT_PUBLIC_STATS_API_HOST

Use the url (not just the host) with the port where the stats service is running. This enables the stats menu item in the UI. If a value is not provided, the stats menu item does not appear.

NEXT_PUBLIC_NETWORK_NAME

<network-name>

NEXT_PUBLIC_NETWORK_ID

<network-id>

Needed to allow interactions with smart contracts -this is the standard chain ID.

NEXT_PUBLIC_NETWORK_RPC_URL

<public_url>

Also needed for smart contract interactions.

NEXT_PUBLIC_NETWORK_CURRENCY_NAME

<full-currency-name> ie Ether

Not used in UI, but is used when user adds the network to his wallet, e.g Metamask. More info.

NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL

<currency-abbreviation> ie. ETH

Used in the UI to display the native currency name.

NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS

18

Currency decimals, 18 is standard.

NEXT_PUBLIC_API_BASE_PATH

/

Will usually remain as the base value. This can be changed to forward to a different path if running the old and new UI simultaneously.

NEXT_PUBLIC_FEATURED_NETWORKS

<path-to-json-list>

NEXT_PUBLIC_APP_HOST

localhost

Frontend UI host

NEXT_PUBLIC_APP_PROTOCOL

http

Frontend protocol

NEXT_PUBLIC_HOMEPAGE_CHARTS

"['daily_txs','coin_price','market_cap']"

NEXT_PUBLIC_VISUALIZE_API_HOST

Enables visualizer microservice. Chains can also use the Blockscout visualizer at https://visualizer.services.blockscout.com

NEXT_PUBLIC_IS_TESTNET

'true'

NEXT_PUBLIC_NETWORK_LOGO

<path-to-image>

Chain logo in .svg or .png

NEXT_PUBLIC_NETWORK_ICON

<path-to-image>

Favicon in .svg or .png

NEXT_PUBLIC_HOMEPAGE_PLATE_BACKGROUND

radial-gradient(103.03% 103.03% at 0% 0%, rgba(183, 148, 244, 0.8) 0%, rgba(0, 163, 196, 0.8) 100%), var(--chakra-colors-blue-400)

Background color for the homepage searchbar area. More info is available in the ENVs full documentation.

NEXT_PUBLIC_HOMEPAGE_PLATE_TEXT_COLOR

"rgb(255, 255, 255)"

Color of text in the homepage background area.

NEXT_PUBLIC_API_WEBSOCKET_PROTOCOL

ws

set secure or non-secure websocket protocol.

Customize the UI of your running app instance (for example, homepage appearance, sidebar menu, and links in the footer) or enable certain features (like “My account’, “Marketplace”, “Blockchain interaction”, etc) by passing additional variables to your front-end container. These can be passed during runtime, added to the docker container in the environment: list, or changed within the .env file.

-> Full list of ENVs with example values

-> ENV File example

Last updated