📋 Overview

This guide will help you quickly deploy an X Layer self-hosted RPC node, providing complete L2 blockchain data access services.

⚠️ Important: Migration from Legacy Mainnet /Testnet

If you were previously running nodes on the legacy X Layer mainnet/ Testnet, please note:

• Data migration: Previous blockchain data is incompatible with the current version
• Configuration changes: Updated bootnodes, network parameters, and configuration files
• Fresh deployment required: You’ll need to deploy a completely new node instance

💻 System Requirements

• Operating System: Linux (Ubuntu 20.04+ recommended)
• Memory: Minimum 8GB, recommended 16GB+
• Storage: Minimum 100GB SSD, recommended 500GB+
• Network: Stable internet connection
• Docker: Docker 20.10+ and Docker Compose 2.0+

⚡ Quick Deployment

🎯 Option 1: One-Click Installation (Recommended)

The easiest way to deploy your X Layer RPC node with minimal configuration:

# One-click installation and setup
curl -fsSL <https://raw.githubusercontent.com/okx/xlayer-toolkit/main/scripts/rpc-setup/one-click-setup.sh> -o one-click-setup.sh
chmod +x one-click-setup.sh && ./one-click-setup.sh