Deploy on your own hardware

This guide will help you deploy and run a Hybrid Integrity Node on your own server or local machine. Ideal for technical users who want full control and direct self-hosting.

---

Pre-requisites

Before you begin, make sure you have:

✅ Docker & Docker Compose installed

• The easiest option is Docker Desktop, which bundles both.

• Alternatively, you can install them separately:

  • Docker Engine Installation Guide

  • Docker Compose Installation Guide

✅ A wallet with your Operator Private Key, funded with a small amount of ETH on Arbitrum to pay for gas.

---

Step 1: Clone the Repository

Open a terminal on your machine and run:

git clone https://github.com/buildonhybrid/integrity-node.git
cd integrity-node

This downloads the latest Hybrid Integrity Node source code and moves you into its directory.

---

Step 2: Review the Repository

You can explore the cloned folder in your file manager or a text editor. The structure should match what’s shown in the repository’s README.

---

Step 3: Create a .env Configuration File

In the root of the repository, create a new file named .env. This will hold your node’s settings.

Add the following lines:

RPC_URL=https://arb1.arbitrum.io/rpc
OPERATOR_PRIVATE_KEY=your_private_key_here
PROTOCOL_CONTRACT_ADDRESS=0x070Af5bcE820f61e409417AfF9b4C1B15B6537df

✅ Notes:

• RPC_URL: Use any Arbitrum RPC endpoint. The above is a reliable public one.

• OPERATOR_PRIVATE_KEY: Your wallet’s private key that will operate the node. ⚠️ Ensure this wallet has enough ETH on Arbitrum for gas.

• PROTOCOL_CONTRACT_ADDRESS: Provided in the repository’s README.

---

Step 4: Start the Node with Docker Compose

In the same terminal, run:

docker compose up -d

This does the following:

• Pulls the latest Docker images.

• Starts your node in detached mode (runs in the background).

✅ What’s running:

• hybrid-node: Core job processor.

• watchtower: Monitors for new container updates and auto-updates every 3 hours.

---

Step 5: Monitor Node Logs

You can view live logs to confirm your node is running properly:

docker compose logs -f hybrid-node

---

Step 6: Delegate Licenses

1. Go to the Hybrid Delegation Dashboard.

2. Connect the wallet that holds your Integrity Node License NFTs.

3. Click “Delegate NFT”, input your OPERATOR address (the wallet from .env), and choose how many licenses to delegate (up to 50 per operator).

---

Step 7: Restarting or Stopping Your Node

• To stop your node:

docker compose down

• To pull the latest images and restart:

docker compose up -d --pull always

---

✅ You’re Done!

Your Integrity Node is now fully operational, securing the Hybrid network and earning rewards. You can check your node status anytime on the Delegation Dashboard.