# FAQ & Troubleshooting

#### Can I redelegate my licenses to another node?

Yes. First undelegate your licenses in the Hybrid Delegation Dashboard, then delegate them to a new Operator Address.

***

#### What if my node stops running?

* **For self-hosted nodes:** Run `docker-compose up -d` again. If needed, pull the latest image with `docker-compose down && docker-compose up -d --pull always`.
* **For NodeOps:** Check your NodeOps Console. Ensure your subscription is active and renew if necessary.

***

#### Where are my rewards?

Rewards accumulate continuously. You can view and claim them on a monthly basis through the Hybrid Node Portal.

***

#### Can I run more than one node?

Yes. You can deploy multiple nodes — either on separate machines (for self-hosted) or multiple instances on NodeOps — and distribute your licenses across them.

***

#### How many licenses can a single node handle?

Each node can have up to **50 licenses delegated** to it.

***

#### Do I need to keep my wallet connected 24/7?

No. Your wallet is only required to delegate licenses and claim rewards. The node runs independently after delegation.

***

#### What happens if my subscription on NodeOps expires?

Your node will stop running and appear inactive on the dashboard. To resume, renew your plan on NodeOps.

***

#### What are the technical requirements if I self-host?

* A Linux server with Docker & Docker Compose installed.
* Recommended: 2 vCPU, 4GB RAM, 50GB SSD storage.
* Stable internet connection with static IP preferred.

***

#### What RPC URL should I use?

Use a reliable Arbitrum RPC endpoint. You can use public endpoints like Alchemy, QuickNode, or your own node. Example:

```
arduinoKopiërenBewerkenhttps://arb-mainnet.g.alchemy.com/v2/<API_KEY>
```

***

#### Is my operator private key safe?

Your private key is stored in your `.env` for the container to sign on-chain transactions. Keep your server secure and never share this key.

***

#### How do I monitor my node?

* **Self-hosted:** Use `docker-compose logs -f hybrid-node` to see live activity.
* **NodeOps:** View uptime and status directly on your NodeFolio dashboard.

***

#### Can I claim rewards anytime?

Rewards accumulate continuously but can only be claimed on a monthly basis.\
Visit the Hybrid Node Portal under the Rewards tab to claim your rewards each month.

***

#### Will there be penalties for downtime?

Nodes must maintain uptime for stable network operations. Prolonged downtime may reduce your rewards or impact eligibility in future incentive programs.

***

#### How do I update my self-hosted node?

The Watchtower service automatically pulls the latest docker image every 3 hours. To force an update manually, run:

```bash
docker-compose down && docker-compose up -d --pull always
```

***

#### What happens if I lose access to my server?

You’ll need to spin up a new server, redeploy the node with your license, and re-delegate. Make sure your wallet holding the licenses is secure.

***

#### How do I undelegate my licenses?

Go to the Hybrid Delegation Dashboard, find your active delegations, and select “Undelegate.” You can then delegate them to another node.

***

#### Who do I contact if something breaks?

* **NodeOps issues:** Use NodeOps’ live support or ticketing inside their console.
* **Hybrid delegation or reward issues:** Reach out in the Hybrid Telegram Community (<https://t.me/hybridcommunity>) or via official support channels.

***

#### Can you stake from multiple wallets holding NFT licenses?

You cannot stake from multiple wallets (holding NFT licenses) into the same operator address.

***

### 🛠 Troubleshooting

#### Do I need ETH on Arbitrum?

Yes. Make sure there is ETH on Arbitrum in your operator wallet address.\
If you’re using a NaaS provider, ensure a small amount of ETH is sent to that wallet. Without this, the node will be unable to respond to incoming challenges or heartbeats from the network.

#### I see “Action Required” on NodeOps

This means you’ve purchased and deployed but haven’t delegated your licenses yet. Copy your Operator Address and complete delegation on the Hybrid dashboard.

***

#### My node shows “Running” but no rewards?

Make sure you have actually delegated licenses to the node. Deployment alone does not start earning — it needs licenses delegated.

***

#### Wallet won’t connect?

* Ensure you’re on the right network (Arbitrum).
* Try clearing your browser cache or reconnecting via MetaMask, WalletConnect, or Coinbase Wallet.

***

#### Rewards aren’t updating?

Rewards update Monthly. If you see delays, wait a few minutes or refresh your dashboard. Persistent issues? Contact support.


---

# 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.buildonhybrid.com/manage-integrity-nodes/faq-and-troubleshooting.md?ask=<question>
```

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.
