Skip to main content

Managing Nodes

This guide covers all aspects of node management, from adding new machines to configuring settings and handling customer requests.

Adding New Nodes​

Prerequisites​

Before adding an node, ensure:

  1. Node Software Running: Your GPU machine has the node program running
  2. Network Access: Machine is accessible from the internet
  3. Miner Server Connected: Your central miner server is running and connected
  4. Wallet Setup: EVM address is associated with your hotkey

Registration Process​

  1. Access Add Executor Modal:

    • Navigate to the Executors page
    • Click the "Add Executor" button
    • A popup modal will appear

  2. Fill Required Information:

    • GPU Type: Select from available options (RTX 4090, A100, etc.)
    • GPU Count: Enter the number of GPUs in the machine
    • Machine IP Address: Public IP address of your node
    • Port: Port number where the node program is running
    • Price Per Hour: Set your rental rate (optional, defaults to market rate)
Price Per Hour

Price can be empty, then it will use the market rate price when rented.

  1. Submit Registration:
    • Review all information for accuracy
    • Click "Add Executor" to register

Synchronization​

Sync From the Central Miner Server​

Sync nodes from your miner server to the portal:

  • Purpose: Import node configurations from your miner server
  • When to Use: After setting up nodes directly on your server
  • Process: Click "Sync From Miner Server" button
  • Result: Nodes configured on your server appear in the portal
Note

When you first login on portal, the sync process will be done automatically for you.

Sync Into Miner Server​

Sync node configurations from the portal to your miner server:

  • Purpose: Export portal configurations to your miner server
  • When to Use: After making changes in the portal that need to be reflected on your server if your server lost connection at that moment.
  • Process: Click "Sync Into Miner Server" button
  • Result: Portal configurations are applied to your miner server
Note

The syncing process is done automatically as long as your miner server is connected to the portal backend and you barely need to do manual sync at all.

Synchronization

Always ensure your miner server is running and accessible before attempting synchronization.

Post-Registration Steps​

After successful registration:

  1. Deposit Collateral: Fund your node to start receiving score and incentives on subnet
  2. Monitor Status: Check that the node appears as active
  3. Configure Settings: Set notice periods and other parameters

Price Management​

  1. Access Price Settings:

    • Go to your node details page
    • Click "Update Price" button
    • Enter new hourly rate

  2. Price Considerations:

    • Minimum Viable Price: Cover operational costs
    • Competitive Pricing: Stay competitive with market rates
Price Updates

Price changes take effect immediately and apply to new rental requests. Existing rentals continue at their original rate.

Notice Period Management​

Understanding Notice Periods​

Notice periods allow you to schedule maintenance for rented machines without deposited collateral being slashed:

  • Requirement
    • Notice period should be scheduled 24 hours ahead.
    • Maximum period is 60 mins
  • Purpose:
    • Give customers advance warning of planned downtime
    • Give miners safe machine maintenance period without collateral getting slashed

Setting Notice Periods​

  • Go to node management page
  • Find the "Notice Period" section
  • Select the start time. (minimum 24 hours later from now)
  • Enter desired notice period (maximum 60 mins)
Note

Once the notice period is scheduled, it will send an email to the customer who rented the machine and let them know.

Notify Machine Request from Customer​

Respond to customer requests efficiently:

  1. Access Notify Feature:

    • Go to your node details page
    • Click the "Notify" button in the top-right corner
    • A modal window displays available machine requests

  2. Select and Notify:

    • Review available machine requests
    • Select appropriate requests based on your node's capabilities
    • Click "Notify" to send notification to the renter

Node Deletion​

When to Delete an Node​

Consider deleting an node when:

  • Hardware Issues: Machine is no longer functional
  • Upgrade Plans: Replacing with better hardware
  • Cost Optimization: Reducing operational costs
  • Relocation: Moving to a different location

Deletion Process​

Important

Deleting an node without proper reclaim process will result in collateral slashing. Always follow the reclaim procedure first.

  1. Reclaim Collateral First:

    • Submit a reclaim request
    • Wait for approval
    • Finalize the reclaim process

  2. Delete Node:

    • Delete from the portal

Troubleshooting​

Common Issues​

Node Not Appearing​

  • Deposit Collateral: Verify the required collateral amount is deposited
  • Check Registration: Verify all required fields were filled correctly
  • Network Connectivity: Ensure machine is accessible from the internet
  • Miner Server: Confirm your miner server is running and connected
  • Validation: Wait for validation process (minimum 15 minutes) to complete