# Docker ## System Requirements | CPU | OS | RAM | DISK | | --------- | ------------ | --- | ---- | | 4-8 cores | Ubuntu 24.04 | 16 | 5TB | {% hint style="info" %} The Optimism Sepolia Archive Node has a size of 2.3TB as of 3/10/2025. {% endhint %} {% hint style="info" %} Subgraphs using callHandlers requires the RPC client to support the Parity Tracing API. With Optimism sepolia we observe that `erigon` supports the parity tracing API, while `geth` does not.\ \ This guide shows how to set up a `geth` client. {% endhint %} ## Pre-Requisites #### Update System ```bash sudo apt update -y && sudo apt upgrade -y && sudo apt autoremove -y sudo apt install -y git gcc make --fix-missing ``` #### Installl Docker ```bash # Update and upgrade packages sudo apt-get update sudo apt-get upgrade -y ### Docker and docker compose prerequisites sudo apt-get install -y curl sudo apt-get install -y gnupg sudo apt-get install -y ca-certificates sudo apt-get install -y lsb-release ### Download the docker gpg file to Ubuntu sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg ### Add Docker and docker compose support to the Ubuntu's packages list echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update ### Install docker and docker compose on Ubuntu sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin sudo usermod -aG docker $(whoami) ### Verify the Docker and docker compose install on Ubuntu sudo docker run hello-world ``` ## Firewall Configuration #### Set Explicit Firewall Configuration ```bash sudo ufw default deny incoming && sudo ufw default allow outgoing ``` #### Allow SSH ```bash sudo ufw allow 22/tcp ``` #### Allow Connections for OP-NODE & OP-GETH ```bash sudo ufw allow 8546 sudo ufw allow 9545 sudo ufw allow 8545 sudo ufw allow 3000 ``` #### Enable Firewall Rules ```bash sudo ufw enable ``` #### Check Status of Firewall Rules (UFW) ```bash sudo ufw status verbose ``` ## Clone the Optimism Docker Setup Directory ### Create Directories ```bash git clone https://github.com/smartcontracts/simple-optimism-node.git cd simple-optimism-node ``` #### Copy .env.example to .env ```bash cp .env.example .env ``` ## Configure the .env file #### This is a sample of how to configure the .env for op-sepolia node {% hint style="info" %} If port 8545 isn't working, you can connect to the default port for the l2 geth execution node port - 9993 {% endhint %} ```bash ############################################################################### # ↓ REQUIRED ↓ # ############################################################################### # Network to run the node on ("op-mainnet" or "op-sepolia") NETWORK_NAME=op-sepolia # Type of node to run ("full" or "archive"), note that "archive" is 10x bigger NODE_TYPE=archive ############################################################################### # ↓ REQUIRED (BEDROCK) ↓ # ############################################################################### # L1 node that the op-node (Bedrock) will get chain data from OP_NODE__RPC_ENDPOINT= # L1 beacon endpoint, you can setup your own or use Quicknode OP_NODE__L1_BEACON= # Type of RPC that op-node is connected to, see README OP_NODE__RPC_TYPE=basic # Reference L2 node to run healthcheck against HEALTHCHECK__REFERENCE_RPC_PROVIDER=https://sepolia.optimism.io ############################################################################### # ↓ OPTIONAL (BEDROCK) ↓ # ############################################################################### # Optional provider to serve legacy RPC requests, see README OP_GETH__HISTORICAL_RPC=https://mainnet.optimism.io # Set to "full" to force op-geth to use --syncmode=full OP_GETH__SYNCMODE= ############################################################################### # ↓ OPTIONAL ↓ # ############################################################################### # Feel free to customize your image tag if you want, uses "latest" by default # See here for all available images: https://hub.docker.com/u/ethereumoptimism IMAGE_TAG__L2GETH= IMAGE_TAG__DTL= IMAGE_TAG__HEALTCHECK= IMAGE_TAG__PROMETHEUS= IMAGE_TAG__GRAFANA= IMAGE_TAG__INFLUXDB= IMAGE_TAG__OP_GETH= IMAGE_TAG__OP_NODE= # Exposed server ports (must be unique) # See docker-compose.yml for default values PORT__L2GETH_HTTP=8545 PORT__L2GETH_WS= PORT__DTL= PORT__HEALTHCHECK_METRICS= PORT__PROMETHEUS= PORT__GRAFANA= PORT__INFLUXDB= PORT__TORRENT_UI= PORT__TORRENT= PORT__OP_GETH_HTTP= PORT__OP_GETH_WS= PORT__OP_GETH_P2P= PORT__OP_NODE_P2P= PORT__OP_NODE_HTTP= ``` You can get more info on the env config in this link - The docker-compose.yml file can be found here ### Operating the Node ```bash docker compose up -d --build ``` ## View the logs ```bash docker compose logs -f --tail 10 ``` ### Monitoring Run progress.sh to estimate remaining sync time and speed. ```bash ./progress.sh ``` ``` Chain ID: 11155420 Sampling, please wait Blocks per minute: 30 Hours until sync completed: ... ``` #### Grafana dashboard Grafana is exposed at [http://localhost:3000](http://localhost:3000/) and comes with one pre-loaded dashboard ("Simple Node Dashboard"). Use the following login details to access the dashboard: * Username: `admin` * Password: `optimism`
## Query Node #### Check Sync Status ```bash curl -H "Content-Type: application/json" \ -X POST --data '{"jsonrpc":"2.0", "method":"eth_syncing", "params":[], "id":1}' \ http://localhost:8545 or 9993 # If node is done syncing - the response should resemble the below. {"jsonrpc":"2.0","id":1,"result":false} ``` #### Check optimism sync status ``` curl -X POST -H "Content-Type: application/json" --data \ '{"jsonrpc":"2.0","method":"optimism_syncStatus","params":[],"id":1}' \ http://localhost:9545 ``` ```bash {"jsonrpc":"2.0","id":1,"result":{"current_l1":{"hash":"0xda1a28e8d035386478138aa1941d324bf39ac9ff57f4fbcf72ff98450f2c2590","number":7876040,"parentHash":"0x3a3a56dd92718df3b55ad48d3b8adfcf2a1741f7ec1478b9ec9bcf152a4dbc26","timestamp":1741642332},"current_l1_finalized".... ``` #### Check Block Number ```bash curl -H "Content-Type: application/json" \ -X POST --data '{"jsonrpc":"2.0", "method":"eth_blockNumber", "params":[], "id":1}' \ http://localhost:8545 or 9993 # Response should resemble the below. {"jsonrpc":"2.0","id":1,"result":"0x17c3e4e"} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.infradao.com/archive-nodes-101/optimism-sepolia/docker.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.