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.

Table of contents

• Features
• Installation
• Configuration
• CLI
• Development
• Troubleshooting
• Enterprise
• Support the project
• License

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

	Community Edition (this repo)	Enterprise (zyvor.dev)
Support	GitHub Issues	SLA, sales@zyvor.dev, professional services
Scope	Open-source daemon	Supported multi-cloud production rollouts
Features	Multi-cloud metadata clients, event-driven reconfiguration, policy-based routing	Same codebase + fleet automation and rollout support
Platform	cloud-netconfig	HyperSDK migration and operations suite

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.

Support the project

cloud-netconfig Community Edition is free and open source, maintained by Susant Sahani · Zyvor AI Labs

• Enterprise / production: zyvor.dev/contact · sales@zyvor.dev
• Community help: GitHub Issues

License

Open source (Apache-2.0)

This repository is licensed under the Apache License, Version 2.0. You may use, modify, and run it for personal, lab, and commercial production use at no charge, subject to Apache-2.0 (preserve notices / NOTICE where required).

Enterprise

Production support, SLAs, and Zyvor Enterprise products are licensed separately. Contact sales@zyvor.dev or see zyvor.dev.