Skip to main content
See the ENV Variables page for more info on specific variables mentioned below.
Note: if you’ve previously deployed and are updating your BlockScout version with new assets, be sure to remove static assets from the previous build (use mix phx.digest.cleanor manually delete assets located in apps/block_scout_web/priv/static folder) before updating current files and restarting/rebuilding BlockScout.In order to rebuild new front-end assets run the following. *Note: If preferred, use npm ci rather than npm install to strictly follow all package versions in *package-lock.json
  1. cd apps/block_scout_web/assets; npm install && node_modules/webpack/bin/webpack.js --mode production; cd -
  2. mix phx.digest
  1. Theme Colors and other CSS-based attributes: See CSS Configs and Presets to set your instance to the stylesheet you want to use.
  2. Logos: Use the LOGO and FOOTER_LOGO env variables to direct to your uploaded logos. Logos and other assets are located in the
    apps/block_scout_web/assets/static/images folder.
  3. Coin: Customize the coin symbol using the COIN & COINGECKO_COIN_ID env variables.
  4. MetaData: MetaTags can be adjusted for various pages in the templates area. For the home page, tag data is rendered from here:
    /apps/block_scout_web/lib/block_scout_web/templates/chain/_metatags.html.eex
  5. Titles / Subtitles: Browser tab displays the title from the 2 SUBNETWORK + NETWORK env variables.
  6. Favicon: replace the current favicons located in the
    apps/block_scout_web/assets/static/images folder.
  7. Menus: Use the APPS_MENU env variable to include an apps menu and EXTERNAL_APPS to populate the menu.
  8. Top navigation bar: Data is rendered from here:
    /apps/block_scout_web/lib/block_scout_web/templates/layout/_topnav.html.eex
  9. Footer: Data is rendered from here:
    /apps/block_scout_web/lib/block_scout_web/templates/layout/_footer.html.eex
    ENV variables for footer links     a. FOOTER_CHAT_LINK b. FOOTER_FORUM_LINK c. FOOTER_GITHUB_LINK
  10. Custom Theming: Custom theming is available from the BlockScout team. Contact us in Discordfor more information.