# Docker Author \[godwin] ## System Requirements | CPU | OS | RAM | DISK | | -------- | ------------ | ----- | --------- | | 8 cores+ | Ubuntu 24.04 | 32GB+ | >= 500 GB | {% hint style="info" %} *The Unichain Mainnet archive node has a size of 256 GB on August 12th, 2025* {% endhint %} Last updated at: 25th August 2025 ## Pre-Requisites First, update, upgrade, and clean the system: ```bash sudo apt update -y && sudo apt upgrade -y && sudo apt auto-remove -y sudo apt install ufw -y ``` ## Configure Firewall Settings ```bash sudo ufw default deny incoming sudo ufw default allow outgoing sudo ufw allow 22/tcp sudo ufw allow 80 sudo ufw allow 443 sudo ufw allow 8545 sudo ufw allow 8546 sudo ufw allow 30303 sudo ufw allow 6060 ``` ## Install Docker Run this command to remove any conflicting docker ```bash `for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done` ``` Add Docker's official GPG key: ```bash sudo apt-get update sudo apt-get install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc ``` Add the repository to ppt sources: ```bash echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update ``` Install docker ```bash sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # Test docker is working sudo docker run hello-world # Install docker compose sudo apt-get update sudo apt-get install docker-compose-plugin # Test the docker version docker compose version ``` ## Setup Unichain Node Make and switch to the working directory for the ronin node ```bash mkdir /unichain cd unichain ``` Go into the `docker` directory, create a `docker-compose.yml` file with the following configuration: ```bash services: unichain-mainnet-archive: image: testinprod/op-erigon:v2.61.3-0.9.5 container_name: unichain-erigon user: "0:0" ports: - "4145:4145" - "10415:10415" - "10415:10415/udp" - "4146:4146" - "25415:25415" - "25415:25415/udp" - "30415:30415" - "30415:30415/udp" - "8553:8553" entrypoint: ["erigon"] command: - --datadir=/data - --chain=unichain-mainnet - --port=10415 - --p2p.allowed-ports=25415 - --p2p.allowed-ports=30415 - --nat=extip:${IP} - --http.addr=0.0.0.0 - --http.port=4145 - --http.vhosts=* - --http.corsdomain=* - --authrpc.addr=0.0.0.0 - --authrpc.port=8553 - --authrpc.vhosts=* - --authrpc.jwtsecret=/shared/jwt.hex - --http.api=eth,erigon,web3,net,debug,trace,txpool,admin - --rpc.returndata.limit=1100000 - --rpc.gascap=5000000000 - --ws - --ws.port=4146 - --batchSize=256MB - --rpc.evmtimeout=10m restart: unless-stopped stop_grace_period: 3m volumes: - ${HOST_DATA_DIR}:/data:rw - shared:/shared unichain-mainnet-archive-node: image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:aa4db40408094803cf9bc05277734572df46088a container_name: unichain-erigon-opnode user: "0:0" ports: - "4345:4345" - "15415:15415" - "15415:15415/udp" entrypoint: [ "op-node" ] restart: unless-stopped volumes: - ${HOST_NODE_DATA_DIR}:/data - shared:/shared environment: - "OP_NODE_NETWORK=unichain-mainnet" - "OP_NODE_SYNCMODE=execution-layer" - "OP_NODE_L1_ETH_RPC=https://ethereum-rpc.publicnode.com" - "OP_NODE_L2_ENGINE_AUTH=/shared/jwt.hex" - "OP_NODE_L2_ENGINE_RPC=http://unichain-mainnet-archive:8553" - "OP_NODE_LOG_LEVEL=info" - "OP_NODE_METRICS_ADDR=0.0.0.0" - "OP_NODE_METRICS_ENABLED=true" - "OP_NODE_METRICS_PORT=7300" - "OP_NODE_P2P_LISTEN_IP=0.0.0.0" - "OP_NODE_P2P_LISTEN_TCP_PORT=15415" - "OP_NODE_P2P_LISTEN_UDP_PORT=15415" - "OP_NODE_RPC_ADDR=0.0.0.0" - "OP_NODE_P2P_ADVERTISE_IP=your-node-ip" - "OP_NODE_RPC_PORT=4345" - "OP_NODE_SNAPSHOT_LOG=/tmp/op-node-snapshot-log" - "OP_NODE_VERIFIER_L1_CONFS=4" - "OP_NODE_STATIC_PEERS=" - "OP_NODE_L1_RPC_KIND=erigon" - "OP_NODE_L1_TRUST_RPC=false" - "OP_NODE_L1_BEACON=https://ethereum-beacon-api.publicnode.com" - "OP_NODE_L2_ENGINE_KIND=erigon" volumes: shared: ``` Create a `.env` file and add the following content ```bash HOST_DATA_DIR=./erigon-data HOST_NODE_DATA_DIR=./opnode-data IP= ETHEREUM_MAINNET_EXECUTION_RPC=https://ethereum-rpc.publicnode.com ETHEREUM_MAINNET_BEACON_REST=https://ethereum-beacon-api.publicnode.com ETHEREUM_MAINNET_EXECUTION_KIND=erigon ETHEREUM_MAINNET_EXECUTION_TRUST=false ``` ## Run the node ```bash docker-compose up -d ``` ## Monitor the node Use docker logs to monitor the rootstock node. The -f flag ensures you are following the log output. ```bash docker logs unichain-erigon -f --tail 100 ``` You should see a response similar to this once your node starts syncing ```bash [INFO] [08-25|18:39:53.455] [NewPayload] Handling new payload height=25398834 hash=0xd220e5d3141ae8f00d7f5d17ed0cf3e73686973c8c4ad30f821f559ab83b8716 [INFO] [08-25|18:39:53.468] [updateForkchoice] Fork choice update: flushing in-memory state (built by previous newPayload) [INFO] [08-25|18:39:53.477] RPC Daemon notified of new headers from=25398833 to=25398834 amount=1 hash=0xd220e5d3141ae8f00d7f5d17ed0cf3e73686973c8c4ad30f821f559ab83b8716 header sending=10.249µs log sending=261ns [INFO] [08-25|18:39:53.477] head updated hash=0xd220e5d3141ae8f00d7f5d17ed0cf3e73686973c8c4ad30f821f559ab83b8716 number=25398834 [INFO] [08-25|18:39:54.464] [NewPayload] Handling new payload height=25398835 hash=0x178ecdc07b2b98a1548669f927b51e7408d4ce972a0d348d8f56923b73ce8880 [INFO] [08-25|18:39:54.474] [updateForkchoice] Fork choice update: flushing in-memory state (built by previous newPayload) [INFO] [08-25|18:39:54.479] RPC Daemon notified of new headers from=25398834 to=25398835 amount=1 hash=0x178ecdc07b2b98a1548669f927b51e7408d4ce972a0d348d8f56923b73ce8880 header sending=7.194µs log sending=170ns [INFO] [08-25|18:39:54.479] head updated hash=0x178ecdc07b2b98a1548669f927b51e7408d4ce972a0d348d8f56923b73ce8880 number=25398835 ``` ```bash docker logs unichain-erigon-opnode -f --tail 100 ``` ``` t=2025-08-25T18:41:02+0000 lvl=info msg="successfully processed payload" ref=0x333a3441580a6f9dd9b7281fa6d6e1f451ba6881ab9c43c188e3e5c8678eca6e:25398903 txs=17 t=2025-08-25T18:41:03+0000 lvl=info msg="Optimistically queueing unsafe L2 execution payload" id=0x3946f700f9a51f93e869efc81d23e2c899d7b3c8a1e1163cfc20e22be52ad187:25398904 t=2025-08-25T18:41:03+0000 lvl=info msg="Inserted new L2 unsafe block (synchronous)" hash=0x3946f700f9a51f93e869efc81d23e2c899d7b3c8a1e1163cfc20e22be52ad187 number=25398904 newpayload_time=47.100ms fcu2_time=39.884ms total_time=86.986ms mgas=5.116018 mgasps=58.814060037884815 t=2025-08-25T18:41:03+0000 lvl=info msg="Sync progress" reason="new chain head block" l2_finalized=0xca27220fe3f2d1b53089834a7467abb70dc2e618e9ecd4b52fcef038942ada93:25397645 l2_safe=0x8285fd46fecc6610774e81acf406ca326e2a13a2ccdac2254fe15fc10bf1c335:25398753 l2_pending_safe=0x8285fd46fecc6610774e81acf406ca326e2a13a2ccdac2254fe15fc10bf1c335:25398753 l2_unsafe=0x3946f700f9a51f93e869efc81d23e2c899d7b3c8a1e1163cfc20e22be52ad187:25398904 l2_backup_unsafe=0x0000000000000000000000000000000000000000000000000000000000000000:0 l2_time=1756147263 t=2025-08-25T18:41:03+0000 lvl=info msg="successfully processed payload" ref=0x3946f700f9a51f93e869efc81d23e2c899d7b3c8a1e1163cfc20e22be52ad187:25398904 txs=30 ``` ## Query the node Eth syncing status ```bash curl -s -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' http://localhost:4145 | jq ``` Output If the node is done syncing, you should see the below response ```bash { "jsonrpc": "2.0", "id": 1, "result": false } ``` To check the block number ```bash curl -s -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:4145 | jq ``` Output ```bash { "jsonrpc": "2.0", "id": 1, "result": "0x171c46f" } ``` ## References {% embed url="" %} {% embed url="" %} {% embed url="" %} --- # 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/unichain/erigon/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.