# Blockscout: Guides ## Guides ### Get Started - [Blockscout blockchain explorer documentation](https://docs.blockscout.com/index.md): Blockscout is an open-source blockchain explorer for inspecting EVM chains, with support for 1000+ L1s, L2s, L3s, optimistic rollups, and ZK rollups. - [Using an Explorer](https://docs.blockscout.com/get-started/using-an-explorer.md): Use the Blockscout explorer to search blocks, transactions, addresses, and verified contracts, plus set up My Account and access API endpoints. - [Integrating Blockscout into your Application](https://docs.blockscout.com/get-started/integrating-data.md): Integrate Blockscout into your app using the Blockscout API, SDK notifications, MCP server for AI agents, and Chainscout multi-chain data endpoints. - [Running Blockscout](https://docs.blockscout.com/get-started/running-blockscout.md): Run your own Blockscout explorer using Autoscout, Docker, Kubernetes, or manual deployment. Hosted EaaS options and ENV configuration guides included. - [Migration Guide](https://docs.blockscout.com/get-started/migration-guide.md): Migrate from Etherscan or other block explorers to Blockscout: switch links, APIs, and integrations for developers, projects, and end users. - [API Rate Limits](https://docs.blockscout.com/rate-limits.md): Rate limits, credit allowances, and per-endpoint credit costs for each Blockscout API plan tier. ### Using Blockscout - [Widgets: 3rd-Party Data on Address and Contract Pages](https://docs.blockscout.com/using-blockscout/widgets.md): Blockscout widgets surface reputation, airdrop, security, audit, and complexity data from partners like Talent Protocol, Webacy, Trustblock, and more. - [CSV Exports](https://docs.blockscout.com/using-blockscout/export-to-csv.md): Download address-level transactions, internal transactions, token transfers, and logs from a Blockscout explorer as CSV files for analysis. #### Overview - [Blockscout UI Sections and Page Overviews](https://docs.blockscout.com/using-blockscout/overviews.md): Navigate Blockscout UI sections including the top menu, blocks, addresses, transactions, and token pages to explore EVM blockchain data effectively. - [Block Explorer Glossary of Terms](https://docs.blockscout.com/using-blockscout/overviews/glossary-of-terms.md): Definitions of common block explorer terms used in Blockscout including address, block, gas, hash, nonce, validator, token, transaction, and wallet. - [Main Menu: Network, Blockchain, and API Navigation](https://docs.blockscout.com/using-blockscout/overviews/top-menu.md): Overview of Blockscout v2 UI top menu items including network switcher, blockchain data (transactions, blocks, batches, L1/L2), and API access. - [Address Page: EOA Fields, Tabs, and Metrics](https://docs.blockscout.com/using-blockscout/overviews/address-page.md): Explore the Blockscout address page for EOAs: balance, tokens, transactions, ENS names, tags, watchlist, multichain data, and activity analytics. - [Blocks Page: Block Height, Gas, and Rewards](https://docs.blockscout.com/using-blockscout/overviews/blocks.md): Understand Blockscout block views including block height, timestamp, gas used, validator rewards, burnt fees, base fee, and included transactions. - [Transaction Fields Reference: Hash, Gas, Logs, State](https://docs.blockscout.com/using-blockscout/overviews/transaction-fields.md): Reference guide to Blockscout transaction page fields including hash, status, gas, nonce, input data, token transfers, event logs, and state changes. - [Transaction Types: Blob, Coin, Contract, and Token](https://docs.blockscout.com/using-blockscout/overviews/transaction-types.md): How Blockscout categorizes transactions including blob (EIP-4844), coin transfer, contract call, contract creation, token transfer, minting, and burning. - [Beacon Chain Withdrawal Views in Blockscout](https://docs.blockscout.com/using-blockscout/overviews/beacon-chain-withdrawal-views.md): See how Blockscout displays Ethereum beacon chain validator withdrawals on block and address pages, including index, validator index, amount, and recipient. - [Token Info Sources: CoinGecko and Verified Owners](https://docs.blockscout.com/using-blockscout/overviews/token-info.md): Learn where Blockscout token metadata comes from, how CoinGecko and manual owner submissions work, and how to fix incorrect token details. #### My Account - [My Account](https://docs.blockscout.com/using-blockscout/my-account.md): Sign in to Blockscout My Account to add watchlists, private tags, custom ABIs, verified addresses, and receive email notifications on activity. - [Watchlist: Email Alerts for Address Activity](https://docs.blockscout.com/using-blockscout/my-account/watchlist.md): Add EOAs or contracts to your Blockscout watchlist and receive email notifications for native coin, ERC-20, ERC-721, and ERC-1155 token transfers. - [Private tags](https://docs.blockscout.com/using-blockscout/my-account/private-tags.md): Create private address and transaction tags in Blockscout My Account to label wallets, contracts, and transactions for your view only. - [Public Tags: Request and Report Address Labels](https://docs.blockscout.com/using-blockscout/my-account/public-tags.md): Request public tags for your project's contracts or report incorrect labels on Blockscout, improving address discoverability and search visibility. - [API keys](https://docs.blockscout.com/using-blockscout/my-account/api-keys.md): Blockscout API keys have moved out of My Account. Get a universal Blockscout Pro API key at dev.blockscout.com for your explorer requests. - [Custom ABI](https://docs.blockscout.com/using-blockscout/my-account/custom-abi.md): Add a Custom ABI in Blockscout My Account to debug, test, and use the Write Custom feature on both verified and unverified smart contracts. - [My Account setup for chain operators](https://docs.blockscout.com/using-blockscout/my-account/for-developers.md): Developer notes for enabling the My Account feature on a self-hosted Blockscout instance, including env variables and Airtable integration. ##### Verified addresses - [Verified Addresses: Prove Smart Contract Ownership](https://docs.blockscout.com/using-blockscout/my-account/verified-addresses.md): Verify ownership of a deployed smart contract on Blockscout by signing a message, then manage token info, name tags, and address labels from your account. - [Copy and Sign Message for Address Verification](https://docs.blockscout.com/using-blockscout/my-account/verified-addresses/copy-and-sign-message.md): Steps for copying and signing the ownership message required to verify a smart contract address on Blockscout using your deployer wallet. #### Dappscout Apps Marketplace - [Dappscout Apps Marketplace](https://docs.blockscout.com/using-blockscout/blockscout-apps.md): Dappscout is a curated in-explorer marketplace of embedded dapps letting users connect a wallet once and interact across supported chains. - [DApp Integration](https://docs.blockscout.com/using-blockscout/blockscout-apps/dapp-integration.md): Integrate your dapp with Dappscout using iframe support and the Safe Apps SDK to gain top listing, embed inside Blockscout, and share wallets. #### Essential Dapps - [Swap](https://docs.blockscout.com/using-blockscout/essential-dapps/swap.md): Swap and bridge tokens across 18 EVM chains directly inside Blockscout using the LI.FI-powered Essential Dapp and earn Merits for activity. - [Revoke](https://docs.blockscout.com/using-blockscout/essential-dapps/revoke.md): Use the Blockscout Revoke Essential Dapp to review and revoke ERC-20 and NFT token approvals across Ethereum, OP Mainnet, Gnosis, Base, and Ink. - [Multisend](https://docs.blockscout.com/using-blockscout/essential-dapps/multisend.md): Use the Blockscout Multisend Essential Dapp to batch-send ERC-20 tokens to many addresses from a CSV list for airdrops and payroll. #### Merits - [Merits](https://docs.blockscout.com/using-blockscout/merits.md): Blockscout Merits are cross-chain digital rewards earned by using the block explorer. Sign up, connect a wallet, and start collecting Merits. - [Streak Rewards](https://docs.blockscout.com/using-blockscout/merits/streak-rewards.md): Claim Blockscout Merits every day to build a streak and earn bonus rewards every 7 consecutive days, with up to 30 Merits on streak days. - [Activity Pass](https://docs.blockscout.com/using-blockscout/merits/activity-pass.md): The Blockscout Activity Pass unlocks extra Merits for contract verification, dapp usage, and everyday explorer activity, with weekly ranks. - [Leaderboard](https://docs.blockscout.com/using-blockscout/merits/leaderboard.md): The Blockscout Merits leaderboard on the Merits hub ranks accounts by earned Merits each season, with address search and shared rankings. - [Badges](https://docs.blockscout.com/using-blockscout/merits/badges.md): Earn and mint Blockscout Scout Badge NFTs on Base by joining Blockscout campaigns, with Common to Legendary rarity tiers for participants. - [Earn Merits when using Swap](https://docs.blockscout.com/using-blockscout/merits/earn-merits-when-using-swap.md): Earn daily Blockscout Merits by swapping and bridging tokens with Swapscout, distributed automatically based on your fees and daily volume. - [Merits FAQs](https://docs.blockscout.com/using-blockscout/merits/faqs.md): Frequently asked questions about Blockscout Merits and Scout Badges, including daily claims, referral rewards, streaks, and supported chains. #### Token Support - [Token Standards Supported by Blockscout](https://docs.blockscout.com/using-blockscout/token-support.md): Blockscout indexes and displays ERC-20, ERC-721, ERC-1155, ERC-777, and ERC-4626 tokens with balances, transfers, and standard-specific views. - [ERC-1155 Support: Multi-Token Indexing](https://docs.blockscout.com/using-blockscout/token-support/erc-1155-support.md): How Blockscout recognizes ERC-1155 contracts and indexes fungible and non-fungible balances, parses batched transfers, and tracks minting events. - [Adding and Updating Token Info on Blockscout](https://docs.blockscout.com/using-blockscout/token-info.md): Submit or update token name, logo, description, website, and socials on Blockscout using deployer verification, manual review, or expedited processing. ### Developer Support - [For Web3 Developers](https://docs.blockscout.com/devs/for-web3-developers.md): Developer hub for building on Blockscout with links to APIs, contract verification tools, the SDK, Merits integration, and link replacement guides. - [Link to Blockscout](https://docs.blockscout.com/devs/replace-links.md): Swap Etherscan and other block explorer links for Blockscout URLs across transactions, blocks, addresses, and tokens with simple URL replacement. - [Blockscout APIs](https://docs.blockscout.com/devs/apis-redirect.md): Entry point to Blockscout API documentation covering the REST API, JSON RPC endpoints, GraphQL queries, and WebSocket event subscriptions. - [MCP Server](https://docs.blockscout.com/devs/mcp-server.md): Blockscout MCP server wraps the APIs to expose balances, tokens, NFTs, and contract metadata for AI agents, IDEs, and automation tools. - [Blockscout SDK](https://docs.blockscout.com/devs/blockscout-sdk.md): React SDK for integrating Blockscout transaction notifications and history into dApps with real-time updates and mobile-responsive design. - [Chainscout Chains List](https://docs.blockscout.com/devs/chainscout-chains-list.md): Chainscout is a JSON-based directory of EVM networks running Blockscout, including chain IDs and metadata contributed via pull requests. - [Blockscout Software Licence](https://docs.blockscout.com/devs/blockscout-license.md): Overview of the source-available licence adopted in Blockscout v11.0.0, covering permitted use for self-hosted explorers, chains, and resellers. #### Wallet as a Service (WaaS) - [What is WaaS](https://docs.blockscout.com/guides/developer-support/waas.md): Blockscout Wallet as a Service (WaaS) delivers ready-made wallet infrastructure with email or passkey login, swap, on/off ramp, and gas sponsorship. - [Integration Guide](https://docs.blockscout.com/guides/developer-support/wallet-as-a-service-waas/integration-guide.md): Install and integrate the Blockscout global wallet SDK into your dapp with npm, connect to Rootstock or other supported chains, and enable WaaS features. - [Current Integrations](https://docs.blockscout.com/guides/developer-support/wallet-as-a-service-waas/integrations.md): Current Blockscout Wallet as a Service (WaaS) integrations, including the Rootstock Global Wallet and the Polygon Global Wallet for ecosystem users. #### Smart Contract Verification - [Smart Contract Verification](https://docs.blockscout.com/devs/verification.md): Verify deployed smart contracts on Blockscout using source code, standard JSON input, Sourcify, Hardhat, Foundry, Remix, and other methods. - [Verify contracts using the Blockscout UI](https://docs.blockscout.com/devs/verification/blockscout-ui.md): Verify Solidity and Vyper smart contracts directly from the Blockscout UI using seven input methods including flattened source, JSON, and Sourcify. - [Verify smart contracts with Foundry Forge](https://docs.blockscout.com/devs/verification/foundry-verification.md): Verify Solidity smart contracts on Blockscout directly from the Foundry toolchain using Forge's built-in verification support and CLI flags. - [Verify contracts via Sourcify on Blockscout](https://docs.blockscout.com/devs/verification/contracts-verification-via-sourcify.md): Verify smart contracts on Blockscout using the Sourcify verification option, matching metadata and source files against Sourcify's decentralized repo. - [Verify contracts with the Remix IDE plugin](https://docs.blockscout.com/devs/verification/remix-verification.md): Verify smart contracts on Blockscout directly from Remix IDE using the built-in contract verification plugin available since Remix v0.56.0. - [Verify contracts via thirdweb on Blockscout](https://docs.blockscout.com/devs/verification/verification-via-thirdweb.md): Deploy prebuilt contracts across many chains with thirdweb and verify them on Blockscout using the Blockscout contract verification API. - [Stylus Verification](https://docs.blockscout.com/devs/verification/stylus-verification.md): Verify Arbitrum Stylus smart contracts located in public GitHub repositories using the Blockscout verification API and Stylus verifier endpoint. - [Interacting with Smart Contracts](https://docs.blockscout.com/devs/verification/interacting-with-smart-contracts.md): Read from and write to verified smart contracts directly in the Blockscout UI by connecting a web3 wallet like MetaMask to any supported chain. - [Smart contract verification websocket events](https://docs.blockscout.com/devs/verification/websocket-notifications.md): Subscribe to Blockscout websocket notifications for smart contract verification results and automated source lookup lifecycle events on V2 and legacy sockets. ##### Hardhat Verification Plugin - [Verify contracts with the Hardhat plugin on Blockscout](https://docs.blockscout.com/devs/verification/hardhat-verification-plugin.md): Verify smart contracts on Blockscout with the hardhat-verify plugin, including setup steps for Hardhat 3 native support and Hardhat 2 configuration. - [Sourcify plugin for Hardhat](https://docs.blockscout.com/devs/verification/hardhat-verification-plugin/sourcify-plugin-for-hardhat.md): Submit deployed contract sources to Sourcify from your Hardhat project so Blockscout can display verified metadata alongside on-chain contracts. ### Setup and Run Blockscout - [Celestia Node and Indexer for Blockscout](https://docs.blockscout.com/setup/celestia-node-indexer.md): Run a Celestia light node and blobs indexer alongside Blockscout with Docker Compose, PostgreSQL, and env config for mocha or mainnet. - [Testing](https://docs.blockscout.com/setup/testing.md): Run the Blockscout Elixir test suites (indexer, explorer, block_scout_web, ethereum_jsonrpc) with chromedriver, Postgres, Geth, and Nethermind. - [Blockscout Database Schema Reference](https://docs.blockscout.com/setup/db-schema.md): Browse the Blockscout PostgreSQL database schema reference: tables, columns, constraints, and relationships used by the indexer and API. #### Autoscout 1-click Launchpad - [Autoscout Explorer Launchpad](https://docs.blockscout.com/using-blockscout/autoscout.md): Autoscout is Blockscout's self-serve launchpad to deploy a production-ready hosted block explorer for EVM chains and rollups in minutes. - [Creating an Instance](https://docs.blockscout.com/using-blockscout/creating-an-instance.md): Step-by-step guide to configuring an Autoscout explorer instance with chain info, RPC, branding, indexer tuning, and rollup settings. #### General Overview - [Blockscout architecture overview](https://docs.blockscout.com/setup/information-and-settings.md): Explore Blockscout architecture and organization including indexer, web app, API modes, umbrella project layout, ShareLock, and EVM versions. - [Separate Indexer, Web App, And API](https://docs.blockscout.com/setup/information-and-settings/separate-indexer-web-app-and-api.md): Run Blockscout components independently using DISABLE_INDEXER, DISABLE_WEBAPP, and API method env variables to scale services separately. - [Umbrella Project Organization](https://docs.blockscout.com/setup/information-and-settings/umbrella-project.md): How the Blockscout Elixir umbrella project is organized into ethereum_jsonrpc, explorer, block_scout_web, and indexer OTP applications. - [Indexer Architecture Overview](https://docs.blockscout.com/setup/information-and-settings/indexer-architecture-overview.md): Overview of Blockscout indexer architecture: realtime and catchup indexers, secondary and on-demand fetchers, and chain-specific integrations. - [ShareLock](https://docs.blockscout.com/setup/information-and-settings/sharelock.md): Understand PostgreSQL ShareLock behavior in Blockscout and how consistent lock acquisition ordering with Ecto prevents database deadlocks. - [EVM Version Information](https://docs.blockscout.com/setup/information-and-settings/evm-version-information.md): Reference table of EVM hard forks (Prague, Cancun, Shanghai, London, Berlin, and more) with mainnet blocks, opcode changes, and EIPs. #### Requirements - [Requirements](https://docs.blockscout.com/setup/requirements.md): System, hardware, database, node tracing, and JSON-RPC client requirements for running a self-hosted Blockscout explorer instance. - [General backend requirements and prerequisites](https://docs.blockscout.com/setup/requirements/requirements.md): Software dependencies (Erlang, Elixir, PostgreSQL, Node.js, GCC, GMP, and more) required to install and run the Blockscout backend. - [Backend/Frontend Compatibility Matrix](https://docs.blockscout.com/setup/requirements/back-front-compatibility-matrix.md): Version compatibility matrix mapping Blockscout backend releases to supported frontend versions for self-hosted explorer deployments. - [Hardware & Hosting Requirements](https://docs.blockscout.com/setup/requirements/resource-requirements.md): Recommended CPU, RAM, disk, and AWS EC2/RDS PostgreSQL baseline sizing for hosting a Blockscout explorer with an EVM archive node backend. - [Database Storage Requirements](https://docs.blockscout.com/setup/requirements/database-storage-requirements.md): Estimated PostgreSQL storage sizes for indexing Ethereum mainnet, Sepolia, Gnosis, Chiado, and Ethereum Classic in a Blockscout explorer instance. - [Client Setting Requirements](https://docs.blockscout.com/setup/requirements/client-settings.md): Configure Blockscout for Geth, Erigon, Nethermind, Besu, Reth, RSKj, Lotus, and Anvil JSON-RPC clients with the right endpoints and flags. - [Node Tracing / JSON RPC Requirements](https://docs.blockscout.com/setup/requirements/node-tracing-json-rpc-requirements.md): Archive node JSON-RPC methods, tracing endpoints, pending transaction support, and rate limits Blockscout needs to fully index a chain. - [L2 to L1 JSON-RPC method requests](https://docs.blockscout.com/setup/requirements/l2-greater-than-l1-json-rpc-method-requests.md): Reference of L1 JSON-RPC methods and polling patterns Blockscout fetchers use for Arbitrum, Optimism, Scroll, Shibarium, zkSync, and Polygon zkEVM. #### ENV Variables - [Blockscout Environment Variables Overview](https://docs.blockscout.com/setup/env-variables.md): Reference for backend, frontend, and microservice environment variables used to configure a Blockscout explorer instance across chains and integrations. - [Backend environment variables reference for Blockscout](https://docs.blockscout.com/setup/env-variables/backend-env-variables.md): Reference for common Blockscout backend environment variables covering database, indexer, JSON RPC, API, and sanitizer configuration options. - [Backend ENVs for Chain-Specific Configuration](https://docs.blockscout.com/setup/env-variables/backend-envs-chain-specific.md): Backend environment variables for configuring Blockscout per chain type, including CHAIN_TYPE settings for Ethereum, Polygon, rollups, and other networks. - [Backend ENVs for Blockscout Integrations](https://docs.blockscout.com/setup/env-variables/backend-envs-integrations.md): Environment variables for configuring Blockscout backend integrations with Rust microservices, external APIs, and third-party services via MICROSERVICE ENVs. ##### Frontend ENVs: Common - [Frontend ENVs: Common](https://docs.blockscout.com/setup/env-variables/frontend-common-envs.md): Overview of common Blockscout frontend environment variables used to customize explorer UI, features, and container runtime settings. - [Frontend environment variables reference](https://docs.blockscout.com/setup/env-variables/frontend-common-envs/envs.md): Complete reference of Blockscout frontend environment variables for app config, API, UI, features, marketplace, and rollup integrations. - [Deprecated Frontend ENVs](https://docs.blockscout.com/setup/env-variables/frontend-common-envs/deprecated-envs.md): Reference of deprecated Blockscout frontend environment variables, their replacements, defaults, and versions where each was removed. ##### Deprecated Backend ENVs - [Deprecated Backend ENVs](https://docs.blockscout.com/setup/env-variables/deprecated-env-variables.md): Reference table of deprecated Blockscout backend environment variables with defaults, versions introduced, and the release each was removed. #### Deployment - [Blockscout Deployment Methods and Options](https://docs.blockscout.com/setup/deployment.md): Deploy Blockscout with Autoscout, manual setup, Docker Compose, Kubernetes, Kurtosis, Terraform, or Ansible, including microservices and frontend. - [Docker Compose Deployment for Blockscout](https://docs.blockscout.com/setup/deployment/docker-compose-deployment.md): Run a full Blockscout explorer locally with Docker Compose, including backend, frontend, database, and microservices for development and testing. - [Kubernetes Deployment with Helm Charts](https://docs.blockscout.com/setup/deployment/kubernetes-deployment.md): Deploy Blockscout explorer to a Kubernetes cluster using the official Helm charts for backend, frontend, PostgreSQL, and supporting microservices. - [Deploy Blockscout on Rollup Chains](https://docs.blockscout.com/setup/deployment/rollup-deployment.md): Deploy Blockscout as an L2 rollup explorer with environment variables and settings for Optimism, Arbitrum, zkSync, and other supported rollup stacks. - [Deploy Blockscout for Cosmos-Based Chains](https://docs.blockscout.com/setup/deployment/cosmos-based-chains.md): Use Blockscout as a block explorer for Cosmos-based chains through the Fair Math SHUTTLE proxy, which bridges EVM-style RPC requests over WebSocket and HTTP. - [Deploy Blockscout on Avalanche L1 Chains](https://docs.blockscout.com/setup/deployment/avalanche-chains.md): Deploy Blockscout as a built-in add-on with Ava Labs' avalanche-deploy Infrastructure as Code toolkit for Avalanche L1 blockchains and validators. - [Upgrade Guide for Blockscout v7.0 and v8.0](https://docs.blockscout.com/setup/deployment/upgrade-guide-v7-0.md): Step-by-step upgrade instructions for moving existing Blockscout deployments to major versions 7.0 and 8.0, including database migrations and env changes. - [Terraform Deployment for Polygon Supernets](https://docs.blockscout.com/setup/deployment/terraform-deployment.md): Provision Blockscout infrastructure with Terraform configuration files tailored for Polygon supernets, including new VPC or existing VPC deployment options. ##### Manual Deployment Guide - [Manual Deployment Guide for Blockscout](https://docs.blockscout.com/setup/deployment/manual-deployment-guide.md): Manually deploy Blockscout backend, new frontend, and microservices on your own hardware or cloud VM with step-by-step Ubuntu and macOS instructions. - [Manual Blockscout Setup on Ubuntu](https://docs.blockscout.com/setup/deployment/manual-deployment-guide/ubuntu-setup.md): Install and run Blockscout backend, frontend, and PostgreSQL on Ubuntu with apt packages, Erlang, Elixir, and Node.js configuration steps. - [Manual Blockscout Setup on macOS](https://docs.blockscout.com/setup/deployment/manual-deployment-guide/macos-setup.md): Install and run Blockscout backend, frontend, and PostgreSQL on macOS using Homebrew, with step-by-step instructions for a working local explorer. ##### Frontend Migration - [Blockscout Frontend Migration Overview](https://docs.blockscout.com/setup/deployment/frontend-migration.md): Choose a migration path from the legacy Blockscout UI to the new React frontend using Docker Compose, separate services, or a customized backend setup. - [All-in-One Docker Compose Frontend Migration](https://docs.blockscout.com/setup/deployment/frontend-migration/all-in-one-container.md): Migrate to the new Blockscout frontend using the all-in-one docker-compose.yml file that runs backend, frontend, and services in a single stack. - [Frontend Migration with Separate Frontend](https://docs.blockscout.com/setup/deployment/frontend-migration/separate-frontend.md): Run the Blockscout frontend as a separate service using external-frontend.yml so you can customize the UI or host it independently from the backend. - [Frontend Migration with Customized Backend](https://docs.blockscout.com/setup/deployment/frontend-migration/customized-backend.md): Migrate to the new Blockscout frontend while keeping an externally hosted or customized backend using the external-backend.yml Docker Compose file. - [NGINX Proxy Setup for Frontend Migration](https://docs.blockscout.com/setup/deployment/frontend-migration/proxy-setup.md): Configure an NGINX reverse proxy to route API, socket, and sitemap paths to the Blockscout backend while serving the new frontend from the same domain. - [Frontend Migration FAQs](https://docs.blockscout.com/setup/deployment/frontend-migration/faqs.md): Answers to common questions about migrating from the legacy Blockscout UI to the new React frontend, including tutorials, troubleshooting, and support. ##### Manual Deployment (backend + old UI) - [Manual Deployment: Backend and Legacy UI](https://docs.blockscout.com/setup/deployment/manual-old-ui.md): Deploy the Blockscout backend with the deprecated legacy UI on hardware or cloud infrastructure. Use the newer Manual Deployment Guide when possible. - [Clean a Previous Manual Blockscout Instance](https://docs.blockscout.com/setup/deployment/manual-old-ui/check-your-manual-deployment-instance.md): Remove build artifacts, node modules, static assets, and PostgreSQL data from a previous manual Blockscout deployment before redeploying or upgrading. ##### Ansible Deployment (AWS Cloud) - [Ansible + Terraform Deployment Overview](https://docs.blockscout.com/setup/deployment/ansible-deployment/overview.md): Overview of the Blockscout Ansible playbooks and Terraform modules used to provision and deploy a production blockchain explorer on AWS. - [Ansible Deployment Prerequisites](https://docs.blockscout.com/setup/deployment/ansible-deployment/prerequisites.md): Required software, AWS credentials, and Terraform/Ansible dependencies to run the Blockscout deployment playbooks from a jumpbox or local machine. - [Ansible Deployment Variables Reference](https://docs.blockscout.com/setup/deployment/ansible-deployment/variables.md): Reference for infrastructure, Blockscout, and shared YAML variables required by the Ansible playbooks to configure a Blockscout explorer per chain. - [Provision Blockscout Infrastructure on AWS](https://docs.blockscout.com/setup/deployment/ansible-deployment/deploying-the-blockscout-infrastructure.md): Use Ansible and Terraform playbooks to provision AWS infrastructure (VPC, RDS, EC2, S3) required before deploying the Blockscout explorer application. - [Deploy Blockscout Application with Ansible](https://docs.blockscout.com/setup/deployment/ansible-deployment/deploying-blockscout.md): Step-by-step Ansible playbook instructions for deploying the Blockscout application to AWS after provisioning the infrastructure with Terraform. - [Destroy Blockscout AWS Infrastructure](https://docs.blockscout.com/setup/deployment/ansible-deployment/destroying-provisioned-infrastructure.md): Tear down provisioned AWS resources for a Blockscout Ansible deployment using Terraform destroy commands to safely remove VPC, EC2, and RDS assets. - [Ansible Common Additional Tasks](https://docs.blockscout.com/setup/deployment/ansible-deployment/common-additional-tasks.md): Optional Ansible tasks for Blockscout deployments including clearing Terraform cache, migrating the deployer machine, and other maintenance operations. - [Ansible Deployment Common Errors and FAQ](https://docs.blockscout.com/setup/deployment/ansible-deployment/common-errors-and-questions.md): Troubleshoot common Ansible and Terraform deployment errors for Blockscout including S3 403 errors, plan diffs, and other provisioning issues. ###### AWS Permissions & Settings - [AWS Permissions and Settings for Blockscout Deploy](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-permissions.md): AWS permissions, IAM keys, and resources created for Blockscout Terraform and Ansible deployments, including VPC, ALB, ASG, and CodeDeploy setup. - [Creating an AWS Secret Access Key Pair for CLI](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-permissions/creating-a-secret-key-pair.md): Create an AWS access key ID and secret access key from My Security Credentials so the AWS CLI can authenticate for Blockscout Terraform deployment. - [Login with AWS CLI for Blockscout Terraform Deploy](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-permissions/login-with-aws-cli.md): Authenticate the AWS CLI with aws configure for Blockscout Terraform deployment: enter access key, secret, region us-east-1, and JSON output. - [Creating An AWS Certificate For SSL](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-permissions/creating-an-aws-certificate-for-ssl.md): Request and validate a public AWS ACM certificate for SSL on Blockscout, then set the ARN in terraform.tfvars via alb_certificate_arn. - [Manually Clean Terraform Instances on AWS](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-permissions/manually-cleaning-terraform-related-instances.md): Manually remove leftover AWS resources when Terraform destroy fails during Blockscout Ansible deployment, including S3, DynamoDB, and EC2 cleanup. ###### AWS Marketplace (deprecated) - [Blockscout AWS Marketplace Listing (Deprecated)](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace.md): The Blockscout AWS Marketplace listing is deprecated; deploy an explorer on AWS by following the Ansible deployment instructions instead. - [AWS Marketplace Deployment Overview for Blockscout](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/overview.md): Overview of deploying Blockscout via the AWS Marketplace listing, with prerequisites, install steps, archive node setup, updates, and theming links. - [Blockscout CloudFormation Template and AWS Topology](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/cloudformation-template.md): View the Blockscout CloudFormation template components and AWS topology diagram used for stack provisioning on the AWS Marketplace listing. - [AWS Marketplace Prerequisites and Install Parameters](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/aws-marketplace-installation.md): Blockscout AWS Marketplace prerequisites and install parameters: EC2 key pair, ACM certificate, archive node URL, DB password, and Cognito setup. - [Install Blockscout from AWS Marketplace Listing](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/install-from-aws-marketplace.md): Step-by-step guide to launching Blockscout from the AWS Marketplace using CloudFormation, including stack parameters, Cognito login, and DNS setup. - [AWS EC2 Archive Node Setup with OpenEthereum](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/aws-ec2-archive-node-setup.md): Provision an AWS EC2 archive node for Blockscout using OpenEthereum (formerly Parity), with example node.toml configs including xDai settings. - [Updating and Redeploying Blockscout on AWS](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/updating-and-redeploying-in-aws.md): Update or redeploy a Blockscout instance on AWS by uploading a new version, stopping the service, running manual deploy steps, and migrating the DB. - [Customizing CSS on Blockscout AWS Marketplace](https://docs.blockscout.com/setup/deployment/ansible-deployment/aws-marketplace/customizing-css.md): Customize a Blockscout AWS Marketplace deployment by editing _poa_variables.scss, rebuilding static assets, and restarting the blockscout service. #### Microservices - [Microservices](https://docs.blockscout.com/setup/microservices.md): Overview of Blockscout Rust microservices including BENS, eth-bytecode-db, sig-provider, smart contract verifier, stats, and visualizer. - [Blockscout ENS (BENS) Name Service Integration](https://docs.blockscout.com/setup/microservices/blockscout-ens-bens-name-service-integration.md): Integrate the Blockscout ENS (BENS) microservice to add ENS-style name service lookups, subgraphs, and search to your explorer instance. - [Smart contract verification microservice](https://docs.blockscout.com/setup/microservices/smart-contract-verification.md): Deep dive into the Blockscout Rust smart contract verifier microservice supporting Solidity, Vyper, and Sourcify verification over HTTP. #### Configuration Options - [Configuration Options](https://docs.blockscout.com/setup/configuration-options.md): Configure a Blockscout explorer with ENV variables, admin panel, reCAPTCHA, exchange rates, logging, metrics, stats, and other runtime options. - [Blockscout Admin Panel Usage for Hosted Explorers](https://docs.blockscout.com/setup/configuration-options/admin-panel-usage.md): Use the Blockscout admin panel to add custom tags, verify contract ownership, approve and update tokens, and manage metadata on hosted instances. - [Automating Blockscout Restarts with HEART_COMMAND](https://docs.blockscout.com/setup/configuration-options/automating-restarts.md): Configure Blockscout to auto-restart on crash using the HEART_COMMAND env variable, heart beat timeouts, and Erlang crash dump settings. - [Circle CI Build Updates for Blockscout](https://docs.blockscout.com/setup/configuration-options/circle-ci-updates.md): Monitor Blockscout CircleCI build status locally with CCMenu using the provided CircleCI project feed URL and token for the poanetwork repository. - [Charts and Stats Microservice for Blockscout](https://docs.blockscout.com/setup/configuration-options/charts-and-stats.md): Run the Blockscout stats microservice to calculate and display chain charts and counters, with configurable line charts, counters, and update schedules. - [Coin, Token, and Historical Exchange Rates](https://docs.blockscout.com/setup/configuration-options/exchange-rates.md): Configure Blockscout exchange rate sources for coin, token, and historical price data, including split API and indexer setup behavior. - [HAProxy Settings for blockscout.com Routing](https://docs.blockscout.com/setup/configuration-options/haproxy-settings-for-blockscout-com.md): Add a Blockscout instance to blockscout.com by configuring HAProxy ACLs, backends, cookies, and WebSocket routing for org and network URLs. - [Blockscout Logger Configs and Log Rotation](https://docs.blockscout.com/setup/configuration-options/logger-configs.md): Tune Blockscout log level, rotation, max file size, and file count per umbrella app to control disk usage in indexer, explorer, and web logs. - [Blockscout Indexer Memory Usage and Limits](https://docs.blockscout.com/setup/configuration-options/memory-usage.md): Control Blockscout indexer memory with INDEXER_MEMORY_LIMIT, understand soft-limit behavior, queue shedding, and Ethereum mainnet requirements. - [Prometheus and Grafana Metrics for Blockscout](https://docs.blockscout.com/setup/configuration-options/untitled-2.md): Export Blockscout metrics on /metrics for Prometheus and visualize node and web performance in Grafana dashboards using BEAM dashboards. - [My Account Settings for Blockscout Personalization](https://docs.blockscout.com/setup/configuration-options/my-account-settings.md): Configure Blockscout My Account with Ueberauth, Auth0, Sendgrid, and Airtable to enable user login, watchlist alerts, and public tag requests. - [reCAPTCHA Setup for Blockscout CSV and Account](https://docs.blockscout.com/setup/configuration-options/recaptcha.md): Enable Google reCAPTCHA v2 invisible on Blockscout to block bots on CSV exports and account features using site key and secret key ENV variables. - [Reown / WalletConnect Project ID for Contract R/W](https://docs.blockscout.com/setup/configuration-options/walletconnect-project-id-for-contract-read-write.md): Create a Reown (WalletConnect) project ID and set NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID to enable contract read and write in Blockscout. - [Sorting and Cursor-Based Pagination in Blockscout](https://docs.blockscout.com/setup/configuration-options/sorting-and-pagination.md): Use the Blockscout SortingHelper module for Ecto query sorting and cursor-based pagination with dynamic ordering across columns and associations. - [Application Tracing with Spandex and Datadog](https://docs.blockscout.com/setup/configuration-options/tracing.md): Enable Blockscout application tracing via Spandex with Datadog as a backend, configure per-app tracers, and swap in alternative tracing backends. #### Indexing - [Indexing](https://docs.blockscout.com/setup/indexing.md): Understand how Blockscout indexes blocks and internal transactions, monitor progress with SQL queries, and troubleshoot indexing issues. - [How Do I Fix Indexer Timeouts?](https://docs.blockscout.com/setup/indexing/how-do-i-fix-indexer-timeouts.md): Tune Blockscout indexer fetcher batch size and concurrency to resolve JSON-RPC timeout errors and reduce load on the underlying archive node. - [Fix indexer memory errors by adjusting memory usage](https://docs.blockscout.com/setup/indexing/how-do-i-update-memory-consumption-to-fix-indexer-memory-errors.md): Configure INDEXER_MEMORY_LIMIT and understand how the Blockscout indexer memory monitor shrinks work queues to prevent BEAM memory errors. ### FAQs - [User FAQs](https://docs.blockscout.com/faqs/faqs.md): User FAQs for the Blockscout explorer covering transactions, addresses, tokens, verified contracts, My Account features, and common troubleshooting. - [Developer FAQs](https://docs.blockscout.com/faqs/developer-faqs.md): Developer FAQs for Blockscout: running a self-hosted explorer, memory tuning, indexer performance, contract verification, and API troubleshooting. ### Resources - [EaaS: Hosting with Blockscout](https://docs.blockscout.com/resources/premium-features.md): Explorer as a Service (EaaS) from Blockscout provides managed hosting, priority updates, SLA support, and premium features for production chains. - [Contributing to Blockscout](https://docs.blockscout.com/resources/contributing-to-blockscout.md): Contribute to the open-source Blockscout explorer through GitHub pull requests, bug reports, feature proposals, and community collaboration. - [Security Program](https://docs.blockscout.com/resources/security-program.md): Report Blockscout security vulnerabilities through the responsible disclosure program. Guidelines for researchers, reproduction steps, and rewards. - [Media Kit](https://docs.blockscout.com/resources/media-kit.md): Download the Blockscout media kit with official logos, brand assets, and marketing images for Merits, Autoscout, and the core explorer platform. - [Discord Channel](https://docs.blockscout.com/discord-channel.md): Join the Blockscout Discord server to get community support, ask questions about explorer setup, and chat with the Blockscout team and contributors. - [Discussion](https://docs.blockscout.com/discussion.md): Start or join conversations in Blockscout GitHub Discussions to share ideas, request features, and troubleshoot block explorer deployments. - [GitHub Repo](https://docs.blockscout.com/github-repo.md): Browse the open-source Blockscout block explorer source code on GitHub, including releases, issues, and contribution guidelines for developers. #### Release Info - [Release Notes](https://docs.blockscout.com/resources/release-notes.md): Blockscout release notes for the backend indexer and frontend explorer, with links to detailed GitHub changelogs for every version and patch. - [v12.0.0 - Breaking changes and API updates](https://docs.blockscout.com/blockscout-v12-0-0-api-updates-and-breaking-changes.md): Blockscout v12.0.0 breaking changes and behavior updates across the REST, JSON RPC, ETH RPC, and GraphQL APIs, with the actions integrators need to take.