cloud-netconfig

Automatic network configuration for cloud instances using provider metadata (Azure, AWS, GCP, and others). Handles secondary IPs, routing tables, and policy-based routing on multi-interface VMs.

Features

• Multi-cloud metadata clients (Azure, AWS EC2, GCP, and more)
• Event-driven reconfiguration via netlink
• Policy-based routing for multi-homed hosts
• Local HTTP API for instance metadata
• Runs unprivileged with CAP_NET_ADMIN

Installation

git clone https://github.com/hypersdk/cloud-netconfig.git
cd cloud-netconfig
make build
sudo make install
sudo useradd -M -s /usr/bin/nologin cloud-network 2>/dev/null || true
sudo systemctl enable --now cloud-netconfigd

Configuration

Default path: /etc/cloud-network/cloud-network.yaml

logging:
  level: info
  format: text

server:
  listen:
    address: 127.0.0.1
    port: 5209

metadata:
  refresh_interval: 300s
  request_timeout: 10s

network:
  interfaces:
    enabled:
      - eth1
      - eth2
  routing:
    table_base: 9999
    policy_routing: true

Annotated reference: distribution/etc/cloud-network/config.yaml.

CLI

cnctl status system
cnctl show interfaces

Development

cargo build --release
cargo test

Troubleshooting

sudo journalctl -u cloud-netconfigd -f
cnctl status system

Enable debug logging in the config file (logging.level: debug) when diagnosing metadata or routing issues.

Enterprise

Demo	zyvor.dev/demo
ROI	zyvor.dev/roi
Pricing	zyvor.dev/pricing
Contact	zyvor.dev/contact · sales@zyvor.dev

Community Edition is the open-source daemon. Supported multi-cloud rollouts, SLAs, and HyperSDK migration integration → contact Zyvor (not GitHub Issues). Details: docs/enterprise.md.

License

Document	Purpose
LICENSE.txt	LGPL-3.0-or-later — source code
ZYVOR-COMPANY-TERMS.md	Zyvor brand / distribution (see docs/legal/)

Enterprise: sales@zyvor.dev · General: info@zyvor.dev. Security: SECURITY.md.

Support

github.com/hypersdk/cloud-netconfig/issues

Related: netevd · netctl · hypersdk