lightster/dnsmasq-mgmt

Tool for managing `address` entries in dnsmasq

dnsmasq-mgmt

Tool for pointing wildcarded domains to your local development machine, _(*1)

Dnsmasq provides network infrastructure for small networks. dnsmasq-mgmt is a tool that installs Dnsmasq and eases the configuration to locally point domains to IP addresses of your choosing., _(*2)

dnsmasq-mgmt was built to avoid manually updating Dnsmasq or /etc/hosts configuration files., _(*3)

Currently dnsmasq-mgmt is only supported on macOS., _(*4)

Installation

Use composer to install dnsmasq-mgmt via:, _(*5)

composer global require "lightster/dnsmasq-mgmt=~0.0.9"

Then allow dnsmasq-mgmt to restart Dnsmasq and clear the operating system's DNS cache without requesting the sudo password each time:, _(*6)

sudo ~/.composer/vendor/bin/dnsmasq-mgmt sudoers:install

The last step in installation is to actually install Dnsmasq and setup directories utilized by Dnsmasq:, _(*7)

~/.composer/vendor/bin/dnsmasq-mgmt dnsmasq:install

Configuring domains

Adding a domain

To have b.com point and subdomains of b.com point to localhost, run:, _(*8)

~/.composer/vendor/bin/dnsmasq-mgmt address:add b.com 127.0.0.1

Removing a domain

To remove b.com, run:, _(*9)

~/.composer/vendor/bin/dnsmasq-mgmt address:add b.com 127.0.0.1

Advanced usage

Make dnsmasq-mgmt readily available

Rather than needing to call dnsmasq-mgmt with a path of ~/.composer/vendor/bin/dnsmasq-mgmt every time, add ~/.composer/vendor/bin/ to the PATH environment variable in your ~/.bash_profile configuration:, _(*10)

PATH="$PATH:${HOME}/.composer/vendor/bin"

Other commands

dnsmasq-mgmt offers a few other commands. You can get a full list of commands by running the list subcommand:, _(*11)

dnsmasq-mgmt list

Install shell completion

If you are using bash or zsh, you can install shell completion for dnsmasq-mgmt., _(*12)

For Bash, add the following to your ~/.bashrc (or ~/.bash_profile):, _(*13)

source  ~/.composer/vendor/lightster/dnsmasq-mgmt/bin/dnsmasq-mgmt-completion.bash

For zsh, add the following to your ~/.zshrc:, _(*14)

source  ~/.composer/vendor/lightster/dnsmasq-mgmt/bin/dnsmasq-mgmt-completion.zsh