set-ip-address

Node module for setting up network interface(s) ip address.

Usage no npm install needed!

<script type="module">
  import setIpAddress from 'https://cdn.skypack.dev/set-ip-address';
</script>

README

set-ip-address

Node module for setting up network interface(s) ip address.

Build Status

Supported linux network configurations:

  • dhcpcd (/etc/dhcpcd.conf)
  • ifdownup (/etc/network/interfaces)
  • netplan (/etc/netplan/)

Install

yarn add set-ip-address

OR

npm i --save set-ip-address

Basic Usage

var set_ip_address = require('set-ip-address')

var eth0 = {
  interface: 'eth0',
  ip_address: '10.0.0.1',
  prefix: 20,
  gateway: '10.0.0.1',
  nameservers: ['8.8.8.8'],
  optional: true // (netplan) - dont wait for interfaces to avoid boot delay
}

var eth1 {
  interface: 'eth1',
  dhcp: true
}

set_ip_address.configure([eth0, eth1]).then(() => console.log('done writing config files')

Configure VLAN

You can create vlan interface by passing vlanid option. Make sure to load 8021q module to the kernel:

sudo modprobe 8021q
var set_ip_address = require('set-ip-address')

var eth0 = {
  interface: 'eth0',
  ip_address: '10.0.0.1',
  prefix: 20,
  gateway: '10.0.0.1',
  nameservers: ['8.8.8.8']
}

var vlan1 {
  interface: 'eth0',
  vlanid: 10,
  ip_address: '20.0.0.1',
  prefix: 20,
  gateway: '20.0.0.1',
  nameservers: ['8.8.8.8']
}

set_ip_address
  .configure([eth0, vlan1])
  .then(() => console.log('done writing config files')

Configure Bridged Interfaces

var set_ip_address = require('set-ip-address')

var eth0 = {
  interface: 'eth0',
  manual: true
}

var vlan1 {
  interface: 'eth0',
  vlanid: 10,
  manual: true
}

var br0 = {
  interface: 'br0',
  ip_address: '10.0.0.1',
  prefix: 20,
  gateway: '10.0.0.1',
  nameservers: ['8.8.8.8'],
  bridge_ports: ['eth0', 'eth0.10'],
  bridge_opts: {
    stp: true
  }
}

set_ip_address
  .configure([eth0, vlan1, br0])
  .then(() => console.log('done writing config files')

Restart Networking Service

set_ip_address.restartService()
  .then(() => console.log('network service restarted'))

LICENSE

MIT