netjsonconfig

.. image:: https://travis-ci.org/openwisp/netjsonconfig.svg :target: https://travis-ci.org/openwisp/netjsonconfig

.. image:: https://coveralls.io/repos/openwisp/netjsonconfig/badge.svg :target: https://coveralls.io/r/openwisp/netjsonconfig

.. image:: https://requires.io/github/openwisp/netjsonconfig/requirements.svg?branch=master :target: https://requires.io/github/openwisp/netjsonconfig/requirements/?branch=master :alt: Requirements Status

.. image:: https://badge.fury.io/py/netjsonconfig.svg :target: http://badge.fury.io/py/netjsonconfig

.. image:: https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=flat-square :target: https://gitter.im/openwisp/general

Netjsonconfig is part of the OpenWISP project <http://openwisp.org> and it's the official configuration engine of OpenWISP 2 <https://github.com/openwisp/ansible-openwisp2>.

.. image:: http://netjsonconfig.openwisp.org/en/latest/_images/openwisp.org.svg :target: http://openwisp.org

netjsonconfig is a python library that converts NetJSON <http://netjson.org> DeviceConfiguration objects into real router configurations that can be installed on systems like OpenWRT <http://openwrt.org>, LEDE <https://www.lede-project.org/> or OpenWisp Firmware <https://github.com/openwisp/OpenWISP-Firmware>.

Its main features are:

• OpenWRT <http://openwrt.org> / LEDE <https://www.lede-project.org/> support
• OpenWisp Firmware <https://github.com/openwisp/OpenWISP-Firmware>_ support
• OpenVPN <https://openvpn.net>_ support
• Possibility to support more firmwares via custom backends
• Based on the NetJSON RFC <http://netjson.org/rfc.html>_
• Validation based on JSON-Schema <http://json-schema.org/>_
• Templates: store common configurations in templates
• Multiple template inheritance: reduce repetition to the minimum
• File inclusion: easy inclusion of arbitrary files in configuration packages
• Variables: reference variables in the configuration
• Command line utility: easy to use from shell scripts or from other programming languages

Documentation <http://netjsonconfig.openwisp.org/> | Change log <https://github.com/openwisp/netjsonconfig/blob/master/CHANGES.rst> | Support channels <http://openwisp.org/support.html> | Issue Tracker <https://github.com/openwisp/netjsonconfig/issues> | License <https://github.com/openwisp/netjsonconfig/blob/master/LICENSE>_