View Code? Open in Web Editor NEW

This project forked from nmstate/nmstate

Nmstate is a library with an accompanying command line tool that manages host networking settings in a declarative manner.

License: Apache License 2.0

Shell 1.29% Python 30.14% C 0.24% Go 0.32% Rust 67.55% Makefile 0.46%

nmstate's Introduction

Nmstate: A Declarative Network API

A declarative network management API for hosts.

Copr build status, all repos are built for Fedora Linux and RHEL/CentOS Stream/EPEL 8+:

Latest release:
Git base:

Nmstate is a library with an accompanying command line tool that manages host networking settings in a declarative manner. The networking state is described by a pre-defined schema. Reporting of current state and changes to it (desired state) both conform to the schema.

Nmstate is aimed to satisfy enterprise needs to manage host networking through a northbound declarative API and multi provider support on the southbound. NetworkManager acts as the main (and currently the only) provider supported.

Nmstate provides:

Rust crate -- nmstate
Command line tools -- cargo install nmstatectl
Python library -- libnmstate
Go binding
C binding

More document could be found at nmstate.io

The codes of nmstate are licensed under Apache 2.0 except the test codes in tests folder are licensed under LGPL 2.1+

State example:

Desired/Current state example (YAML):

---
dns:
  config:
    server:
      - 192.0.2.1
    search:
      - example.org
routes:
  config:
    - destination: 0.0.0.0/0
      next-hop-interface: eth1
      next-hop-address: 192.0.2.1
interfaces:
  - name: eth1
    type: ethernet
    description: Main-NIC
    state: up
    ipv4:
      enabled: true
      dhcp: false
      address:
        - ip: 192.0.2.9
          prefix-length: 24
    ipv6:
      enabled: false