Blockscout
SupportWebsiteGithubDiscord
  • Blockscout Open-Source Explorer
  • 💡About BlockScout
    • Features
      • Ethereum Bytecode Database Microservice
      • Blockscout Redesign
    • Chains Using Blockscout
    • Partners & Integrations
      • RaaS Providers
      • Vera: Verifier Alliance
        • Adding your chain to the Vera database
        • Programmatic verification via the API
    • News & Media
      • Newsletter & Blog
    • Funding
      • L2 Funding Proposal
        • Aux Funding Images
    • Roadmap
  • 🙎Using Blockscout
    • Getting Started
      • Glossary of Terms
      • Main Menu
      • Blocks
      • Transaction Types
      • Beacon Chain Withdrawal Views
    • My Account
      • Watch list
      • Private tags
      • Public tags
      • API keys
      • Custom ABI
      • Verified addresses
        • Copy and Sign Message
      • For developers
    • Dappscout Apps Marketplace
      • DApp Integration
    • Swapscout
      • Earn Merits when using Swapscout
    • Revokescout
    • Autoscout Explorer Launchpad
    • CSV Exports
    • Token Support
      • ERC-1155 Support
    • Merits
      • Streak rewards
      • Activity Pass
      • Leaderboard
      • Badges
      • FAQs
  • 👩‍💻Developer Support
    • For Web3 Developers
    • Link to Blockscout
    • Blockscout APIs
      • Requests & Limits
      • REST API Endpoints
        • Stats API
        • Interpreter API
      • JSON RPC & ETH Compatible RPC Endpoints
        • Account
        • Block
        • Contract
        • Logs
        • Stats
        • Token
        • Transaction
        • ETH RPC API
      • GraphQL in Blockscout
    • Smart Contract Verification
      • Blockscout UI
      • Blockscout smart-contract verification API
      • Hardhat Verification Plugin
        • Sourcify Plugin for Hardhat
      • Foundry Verification
      • Sourcify Verification
      • OpenZeppelin Contract Verification
      • Automate verifications with Catapulta
      • Verification via thirdweb
      • Interacting with Smart Contracts
    • Integrate Merits
    • Chainscout chains list
  • 🏃‍♂️Setup and Run Blockscout
    • General Overview
      • Separate Indexer, Web App, and API
      • Umbrella Project Organization
      • Indexer Architecture Overview
      • ShareLock
      • EVM Version Information
    • Requirements
      • General Backend Requirements / Blockscout Backend Prerequisites
      • Backend/Frontend Compatibility Matrix
      • Hardware & Hosting Requirements
      • Database Storage Requirements
      • Client Setting Requirements
      • Node Tracing / JSON RPC Requirements
      • L2 -> L1 JSON-RPC Method Requests
    • ☑️ENV Variables
      • Backend ENVs: Common
      • Backend ENVs: Chain-Specific
      • Backend ENVs: Integrations
      • Frontend ENVs: Common
        • ENVs
        • Deprecated ENVs
      • Deprecated Backend ENVs
        • Previous ENV Variable Home Page
    • Deployment
      • ⭐Manual Deployment Guide
        • Ubuntu Setup
        • MacOS setup
      • ⭐Docker-compose Deployment
      • ⭐Kubernetes Deployment
      • Rollup Deployment
      • 🌟Cosmos-based chains
      • 🍀Upgrade Guide (v7.0 & v8.0)
      • Frontend Migration
        • All-In-One Container
        • Separate Frontend
        • Customized Backend
        • Proxy Setup
        • FAQs
      • Manual Deployment (backend + old UI)
        • Manual cleaning an instance from the previous deployment
      • Terraform Deployment
      • Ansible Deployment (AWS Cloud)
        • Overview
        • Prerequisites
        • AWS Permissions & Settings
          • Creating a Secret Key Pair
          • Login with AWS CLI
          • Creating an AWS certificate for SSL
          • Manually Cleaning Terraform Related Instances
        • Variables
        • Deploying the Blockscout Infrastructure
        • Deploying Blockscout
        • Destroying Provisioned Infrastructure
        • Common Additional Tasks
        • Common Errors and Questions
        • AWS Marketplace (deprecated)
          • Overview
          • CloudFormation Template
          • Prerequisites & Install Parameters
          • Install from AWS Marketplace
          • AWS EC2 archive node setup with OpenEthereum (formerly Parity)
          • Updating & Redeploying in AWS
          • Customizing CSS
    • Microservices
      • Blockscout ENS (BENS) Name Service Integration
      • Smart Contract Verification
    • Configuration Options
      • Automating Restarts
      • Branding Configs
      • Circle CI Updates
      • Charts and Stats
      • CSS Configuration & Presets
      • Exchange Rates
      • Front-end Config Files
      • haproxy Settings for Blockscout.com
      • Internationalization
      • Logger Configs
      • Memory Usage
      • Metrics
      • My Account Settings
      • Sorting and Pagination
      • Tracing
      • Reown Project ID for contract Read/Write
    • Indexing
      • How do I fix indexer timeouts?
      • How do I update memory consumption to fix indexer memory errors?
    • Testing
    • DB schema
  • FAQs
    • User FAQs
    • Developer FAQs
  • 🧩Resources
    • EaaS: Hosting with Blockscout
    • Contributing to Blockscout
    • Bug Bounty Program
    • Media kit
    • Release Notes
      • v5.3.0: 10/23/23
      • v5.2.0: 6/20/23
      • v5.1.0: 2/13/23
      • v5.0.0: 1/11/23
    • Discord Channel
    • Discussion
    • GitHub Repo
Powered by GitBook
LogoLogo

Privacy and Terms

  • Privacy Notice
  • Terms and Conditions

Copyright © Blockscout Limited 2023-2024

On this page
  • Configuration file example
  • General Specs
  • xDai archive node configuration

Was this helpful?

Export as PDF
  1. Setup and Run Blockscout
  2. Deployment
  3. Ansible Deployment (AWS Cloud)
  4. AWS Marketplace (deprecated)

AWS EC2 archive node setup with OpenEthereum (formerly Parity)

The following provides an example node setup. Performance related parameters will vary per chain.

Last updated 4 years ago

Was this helpful?

See the for complete instructions for any chain setup

Any chain requires an amount of storage capable of storing all archive data. For best performance choose the best available storage device (ie NVMe SSD).

  1. Setup an EC2 instance and choose the best available storage (ie NVMe SSD).

    • During setup you will . For security purposes, you should limit the inbound traffic to RPC and WebSocket interfaces (default ports are 8545 and 8546). Limit connection to these ports to the BlockScout application server's IP address if setting up BlockScout (find in the details section of your created instance) or to your local network. You can also set limit port connections later through the EC2 -> Security Groups panel.

  2. Specify the private key ( .pem ) file, the user name for your AMI, and the public DNS name for your instance. For example, if you used Amazon Linux 2 or the Amazon Linux AMI, the user name is ec2-user. If ubuntu, the user name is ubuntu.

    Example: ssh -i /path/my-key-pair.pem ec2-user@ec2-198-51-100-1.compute-1.amazonaws.com

  3. Install OpenEthereum from for the corresponding platform

  4. Create a config file called node.toml (see below for config file specs including ) and edit accordingly vim node.toml

  5. Connect and Sync an archive node using the config file. parity --config node.toml

  6. Find your EC2 url to connect with BlockScout: Go to EC2 Dashboard -> Instances -> corresponding archive node instance and record the ip address. When configuring BlockScout you will use this address along with port 8545 to connect via the EthereumJsonRPCHttpURL parameter.

    For example: 192.0.2.1:8545

Additional Resources

  • .

Node.toml file general instructions

Below we provide a general example file as well as the settings we use for our xDai node config. In general:

  • Parity should run in "fatdb+archive+traces" mode with pruning="archive", fatdb="on", tracing="on".

  • Both RPC and WebSockets interfaces should be opened and allow calls to "web3","eth","net","parity","pubsub","traces" APIs.

Configuration file example

General Specs

[parity]
chain = "CHAIN NAME or PATH TO SPEC.JSON"

[network]
nat="ext:<PUBLIC IP>"
warp = false

[rpc]
apis = ["web3","eth","net","parity","traces"]
processing_threads = 8
server_threads = 16
interface = "0.0.0.0"
cors=["all"]

[websockets]
port = 8546
interface = "0.0.0.0"
max_connections = 1000
apis = ["web3","eth","net","parity","pubsub","traces"]
origins = ["all"]
hosts = ["all"]

[ui]
disable = true

[snapshots]
disable_periodic = true

[footprint]
tracing = "on"
pruning = "archive"
fat_db = "on"
cache_size_db = 12000

xDai archive node configuration

These are the settings we use to run the xDai archive node.

[parity]
chain = "xdai"

[network]
nat="ext:<PUBLIC IP>"

[rpc]
apis = ["web3","eth","net", "parity", "traces"]
processing_threads = 50
server_threads = 100
interface = "0.0.0.0"
cors=["all"]

[footprint]
tracing = "on"
pruning = "archive"
fat_db = "on"

[websockets]
max_connections = 1000
interface = "0.0.0.0"
apis = ["web3","eth","net","parity", "pubsub", "traces"]
origins = ["all"]
hosts = ["all"]

[ui]
disable = true

[snapshots]
disable_periodic = true

[mining]
min_gas_price = 1000000000

A full list of configuration options is available at:

The following example file outlines general parameters - Performance-related parameters like processing_threads, server_threads or cache_size_db will vary based on the chain size, available hardware, parity version, general traffic load etc. Often these are adjusted through a trial-and-error process.

This instruction was moved from:

🏃‍♂️
https://wiki.parity.io/Configuring-Parity-Ethereum
https://forum.poa.network/t/example-archive-node-setup-with-parity-on-an-aws-ec2-instance/3077
OpenEthereum Documentation
https://aws.amazon.com/ec2/getting-started/
configure Security Groups
Connect to your instance using SSH
Find info about your instance
GitHub releases page
AWS Marketplace Instructions
See the xDai Docs for instructions on installing a local instance of xDai using OpenEthereum or Nethermind
xDai archive node specs
See below for xDai Archive Node Specs.