Kurtosis-Orbit

Deploy and manage Arbitrum Orbit chains with ease using Kurtosis

Kurtosis-Orbit is a comprehensive deployment tool that allows you to spin up complete Arbitrum Orbit rollup environments in minutes. Built on top of Kurtosis, it provides a simple, reproducible way to deploy L2 chains for development, testing, and experimentation.

DOCS

✨ Features

• 🚀 One-command deployment - Deploy a complete Orbit stack with a single command
• 🔧 Highly configurable - Customize chain parameters, rollup mode, and infrastructure settings
• 🔑 Pre-funded accounts - Development accounts with ETH ready for immediate testing
• 🌉 Bridge integration - Built-in token bridge between L1 and L2
• 📊 Monitoring ready - Optional Blockscout explorer for transaction monitoring
• 🐳 Docker - Run locally with Docker

🚀 Quick Start

Prerequisites

• Docker with 8GB+ RAM allocated
• Kurtosis CLI installed

Deploy Your First Orbit Chain

# Start Kurtosis engine
kurtosis engine start

# Deploy default Orbit chain
kurtosis run github.com/justmert/kurtosis-orbit

# Access your chain (ports will be shown in output)
# Example: http://localhost:PORT for RPC access

Deploy with Custom Configuration

# Create custom config
cat << EOF > my-config.yml
orbit_config:
  chain_name: "MyDevChain"
  chain_id: 999888
  enable_explorer: true
EOF

# Deploy with custom settings
kurtosis run github.com/justmert/kurtosis-orbit --args-file my-config.yml

🏗️ What You Get

After deployment, you'll have a complete Arbitrum Orbit environment including:

• L1 Ethereum chain (local Geth + Lighthouse)
• Arbitrum Orbit L2 chain (sequencer + validator)
• Token bridge for L1 ↔ L2 transfers
• Pre-funded accounts with 1000 ETH each
• Optional block explorer (Blockscout)

📖 Documentation

You can see the hosted docs.

• Getting Started Guide - Step-by-step deployment walkthrough
• Installation Guide - Detailed installation instructions
• Configuration Reference - All available configuration options
• Account Management - Working with development accounts
• Architecture Overview - How Kurtosis-Orbit works
• Troubleshooting - Common issues and solutions

Disable Analytics

To disable analytics tracking, add this to your configuration:

orbit_config:
  enable_analytics: false

Or set the environment variable:

export KURTOSIS_ORBIT_ANALYTICS=false

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🔗 Links

• Kurtosis Documentation
• Arbitrum Documentation
• Arbitrum Orbit