BranchesTags

Repository files navigation

Base

Base Node

Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.

Website base.orgDocsDiscordTwitter BaseFarcaster Base

Quick Start

  1. Ensure you have an Ethereum L1 full node RPC available

  2. Choose your network:

    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia

  3. Configure your L1 endpoints in the appropriate .env file:

    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>

  4. Start the node:

    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build

Supported Clients

  • geth (default)
  • reth
  • nethermind

Requirements

Minimum Requirements

  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose

Production Hardware Specifications

The following are the hardware specifications we use in production:

Geth Full Node

  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4

Reth Archive Node

  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4

[!NOTE] To run the node using a supported client, you can use the following command: CLIENT=supported_client docker compose up --build

Supported clients:

Configuration

Required Settings

  • L1 Configuration:
    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:
      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods

Network Settings

  • Mainnet:
    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org

Performance Settings

  • Cache Settings:
    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"

Optional Features

  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)

For full configuration options, see the .env.mainnet file.

Snapshots

Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.

Supported Networks

NetworkStatus
Mainnet✅
Testnet✅

Troubleshooting

For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.

Disclaimer

THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.

For more information, visit docs.base.org.

About

Everything required to run your own Base node

base.org

Resources

Readme
License

Contributing

Contributing

Security policy

Security policy
Activity

Stars

2 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Base
Base Node
Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains Docker builds to run your own node on the Base network.
Website base.orgDocsDiscordTwitter BaseFarcaster Base
Quick Start
  1. Ensure you have an Ethereum L1 full node RPC available
  2. Choose your network:
    • For mainnet: Use .env.mainnet
    • For testnet: Use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:
    OP_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
OP_NODE_L1_BEACON=<your-preferred-l1-beacon>
OP_NODE_L1_BEACON_ARCHIVER=<your-preferred-l1-beacon-archiver>
  4. Start the node:
    # For mainnet (default):
docker compose up --build
# For testnet:
NETWORK_ENV=.env.sepolia docker compose up --build
# To use a specific client (optional):
CLIENT=reth docker compose up --build
# For testnet with a specific client:
NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
Supported Clients
  • geth (default)
  • reth
  • nethermind
Requirements
Minimum Requirements
  • Modern Multicore CPU
  • 32GB RAM (64GB Recommended)
  • NVMe SSD drive
  • Storage: (2 * current chain size + snapshot size + 20% buffer (to accommodate future growth)
  • Docker and Docker Compose
Production Hardware Specifications
The following are the hardware specifications we use in production:
Geth Full Node
  • Instance: AWS i4i.12xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
Reth Archive Node
  • Instance: AWS i7ie.6xlarge
  • Storage: RAID 0 of all local NVMe drives (/dev/nvme*)
  • Filesystem: ext4
[!NOTE]
To run the node using a supported client, you can use the following command:
CLIENT=supported_client docker compose up --build
Supported clients:
Configuration
Required Settings
  • L1 Configuration:

    • OP_NODE_L1_ETH_RPC: Your Ethereum L1 node RPC endpoint
    • OP_NODE_L1_BEACON: Your L1 beacon node endpoint
    • OP_NODE_L1_BEACON_ARCHIVER: Your L1 beacon archiver endpoint
    • OP_NODE_L1_RPC_KIND: The type of RPC provider being used (default: "debug_geth"). Supported values:

      • alchemy: Alchemy RPC provider
      • quicknode: QuickNode RPC provider
      • infura: Infura RPC provider
      • parity: Parity RPC provider
      • nethermind: Nethermind RPC provider
      • debug_geth: Debug Geth RPC provider
      • erigon: Erigon RPC provider
      • basic: Basic RPC provider (standard receipt fetching only)
      • any: Any available RPC method
      • standard: Standard RPC methods including newer optimized methods
Network Settings
  • Mainnet:

    • RETH_CHAIN=base
    • OP_NODE_NETWORK=base-mainnet
    • Sequencer: https://mainnet-sequencer.base.org
Performance Settings
  • Cache Settings:

    • GETH_CACHE="20480" (20GB)
    • GETH_CACHE_DATABASE="20" (4GB)
    • GETH_CACHE_GC="12"
    • GETH_CACHE_SNAPSHOT="24"
    • GETH_CACHE_TRIE="44"
Optional Features
  • EthStats Monitoring (uncomment to enable)
  • Trusted RPC Mode (uncomment to enable)
  • Snap Sync (experimental)
For full configuration options, see the .env.mainnet file.
Snapshots
Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.
Supported Networks
NetworkStatus
Mainnet✅
Testnet✅
Troubleshooting
For support please join our Discord post in 🛠｜node-operators. You can alternatively open a new GitHub issue.
Disclaimer
THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.
For more information, visit docs.base.org.
About
Everything required to run your own Base node
base.org
Resources
Readme
License
Contributing
Contributing
Security policy
Security policy
Activity
Stars
2 stars
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages