# VMID 2101 Network Configuration

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Date**: 2025-01-19  
**VMID**: 2101  
**Hostname**: besu-rpc-core-1  
**Expected IP**: 192.168.11.211

---

## Current Configuration

### Proxmox Container Config
```bash
net0: name=eth0,bridge=vmbr0,firewall=0,hwaddr=BC:24:11:16:E7:02,type=veth
```

**Issue**: No IP address configured in `net0` parameter!

### Expected Configuration
```bash
net0: name=eth0,bridge=vmbr0,firewall=0,hwaddr=BC:24:11:16:E7:02,ip=192.168.11.211/24,gw=192.168.11.1,type=veth
```

---

## Current Network Status

### Container Interfaces
- **Loopback (lo)**: `127.0.0.1/8` ✓
- **IPv6 Link-local**: `fe80::be24:11ff:fe16:e702/64` ✓
- **eth0**: ❌ **NO IPv4 ADDRESS ASSIGNED**

### Routing
- ❌ **NO DEFAULT ROUTE** - This explains why internet access fails!
- ❌ No gateway configured

### DNS
- Nameservers: `8.8.8.8`, `8.8.4.4` (configured but unreachable without gateway)

---

## Problem

The container has **no IP address assigned** and **no default gateway**, which means:
1. ❌ Cannot reach internet (no gateway)
2. ❌ Cannot reach other network nodes (no IP)
3. ✅ Can use `localhost:8545` for Besu RPC (runs on same container)

---

## Solution

### Option 1: Configure Static IP (Recommended)

```bash
# On Proxmox host (192.168.11.10)
pct set 2101 -net0 name=eth0,bridge=vmbr0,firewall=0,hwaddr=BC:24:11:16:E7:02,ip=192.168.11.211/24,gw=192.168.11.1,type=veth

# Restart container
pct stop 2101
pct start 2101
```

### Option 2: Use DHCP (if available)

```bash
# On Proxmox host
pct set 2101 -net0 name=eth0,bridge=vmbr0,firewall=0,hwaddr=BC:24:11:16:E7:02,type=veth,dhcp=1

# Restart container
pct stop 2101
pct start 2101
```

---

## Verification

After configuring IP:

```bash
# Check container IP
pct exec 2101 -- ip addr show eth0

# Check routing
pct exec 2101 -- ip route show

# Test internet connectivity
pct exec 2101 -- ping -c 2 8.8.8.8

# Test RPC (should still work)
pct exec 2101 -- curl -X POST http://localhost:8545 -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
```

---

## Current Workaround

Since the container has no IP/gateway but Besu runs on `localhost`:
- ✅ Deployments can use `http://localhost:8545` from within the container
- ❌ Container cannot download Solidity compilers (no internet)
- ✅ Can copy pre-compiled artifacts from local system

---

**Status**: Network configuration incomplete - IP address and gateway need to be configured.