Skip to content

QUICKSTART.md

Latest commit

 

History

History
78 lines (57 loc) · 1.48 KB

QUICKSTART.md

File metadata and controls

78 lines (57 loc) · 1.48 KB

Hypergraph Hypernode - Quick Start Guide

Get your hypernode running in 5 minutes.

Step 1: Prerequisites

Ensure you have:

  • Linux system (Ubuntu 22.04+ recommended)
  • 4GB RAM minimum
  • 20GB disk space
  • Docker installed

Step 2: Run Setup

./hypernode_bundle/setup-hypernode.sh

This will:

  1. Detect your OS and architecture
  2. Install dependencies (Docker, WireGuard, etc.)
  3. Generate node identity and keys
  4. Register with the Factory
  5. Join the Hypergraph network
  6. Start services

Step 3: Verify

# Check status
./cli/hypergraph-cli.sh status

# View services
docker ps

# Check VPN connection
sudo wg show

Step 4: Access Services

Open your browser:

Next Steps

  1. Configure services: Edit ~/.hypergraph/config.yaml
  2. Monitor: Access Grafana dashboards
  3. Join tribe: Contact admins for tribe assignment
  4. Enable features: Activate optional services

Common Issues

Factory Registration Fails

# Check connectivity
curl https://factory.hypergraph.dev/health

# Re-register
./cli/hypergraph-cli.sh factory register

Services Won't Start

# Run diagnostics
./cli/hypergraph-cli.sh doctor

# Check logs
./cli/hypergraph-cli.sh logs api-gateway

Get Help