Frontend Common ENVs

-> 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.
Variable
Standard value
Info
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
​http://localhost: 8080
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>
String which shows the name of the network in the explorer.
​
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>
​
JSON list which populates this menu item
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']"
Manages charts to display on homepage. Default is daily_txs only.
​
NEXT_PUBLIC_VISUALIZE_API_HOST
​http://localhost:8081​
Enables visualizer microservice. Chains can also use the Blockscout visualizer at https://visualizer.services.blockscout.com​
NEXT_PUBLIC_IS_TESTNET
'true'
Sets testnet text if network is a testnet.
​
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
​

Variable	Standard value	Info
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	http://localhost: 8080	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>	String which shows the name of the network in the explorer.
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>	JSON list which populates this menu item
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']"	Manages charts to display on homepage. Default is `daily_txs` only.
NEXT_PUBLIC_VISUALIZE_API_HOST	http://localhost:8081	Enables visualizer microservice. Chains can also use the Blockscout visualizer at https://visualizer.services.blockscout.com
NEXT_PUBLIC_IS_TESTNET	'true'	Sets testnet text if network is a testnet.
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.

Proxy Setup

FAQs

Last modified 28d ago