Landrush: DNS for Vagrant

Landrush is a simple cross-platform DNS for Vagrant VMs that is visible on both, the guest and the host.

It spins up a small DNS server and redirects DNS traffic from your VMs to use it, automatically registering/unregistering IP addresses of guests as they come up and go down.

Note	This project is currently unmaintained and looking for maintainers! Anybody interested in helping out please contact @hferentschik. I’d be happy to help coach anybody who wants to drop in and pick up the maintainer role for this plugin!

Table of Contents

Installation

Install under Vagrant (1.1 or later):

$ vagrant plugin install landrush

Getting started

Enable the plugin in your Vagrantfile:
```
config.landrush.enabled = true
```
Bring up a machine.
```
$ vagrant up
```
You are able to get your VM’s hostname resolved on your host:
```
$ dig -p 10053 @localhost myhost.vagrant.test
```
If you shut down your guest, the entries associated with it will be removed.

Landrush retrieves your VM’s hostname from either the vagrant config or it uses the system’s actual hostname by running the hostname command. A default hostname of "guest-vm" is assumed if the hostname is otherwise not available.

A Landrush example configuration could look like this:

Vagrant.configure("2") do |config|
  config.vm.box = "ubuntu/xenial64"

  config.landrush.enabled = true

  config.vm.hostname = "myhost.vagrant.test"

  config.landrush.host 'static1.example.com', '1.2.3.4'
  config.landrush.host 'static2.example.com', '2.3.4.5'
end

See the Usage guide for further information.

Available CLI commands

Check out vagrant landrush help for the available commands.

vagrant landrush <command>

commands:
  {start|stop|restart|status}
    control the landrush server daemon
  list, ls
    list all DNS entries known to landrush
  dependentvms, vms
    list vms currently dependent on the landrush server
  set { <host> <ip> | <alias> <host> }
    adds the given host-to-ip or alias-to-hostname mapping.
    Existing host ip addresses will be overwritten
  rm, del { <host> | <alias> | --all }
    delete the given hostname or alias from the server.
     --all removes all entries
  help
    you're lookin at it!

Troubleshooting

See the Troubleshooting guide to resolve issues you face while using Landrush.

Help Out!

This project needs your feedback and help! Please do not hesitate to open issues or submit pull requests. We welcome your input. If you wish to contribute to the development of Landrush, refer to the Contributing guide for details on how you can contribute. The Development guide will help you setup your development environment.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Coredns	10,454	81	417	2 days ago	271	September 08, 2022	69	apache-2.0	Go
CoreDNS is a DNS server that chains plugins
Landrush	669	5		3 years ago	38	May 06, 2019	54	mit	Ruby
A Vagrant plugin that provides a simple DNS server for Vagrant guests
Patoolkit	335			3 years ago			2		Lua
PA Toolkit is a collection of traffic analysis plugins focused on security
Certbot Dns Aliyun	154			25 days ago	4	September 29, 2019	7	other	Python
A certbot dns plugin to obtain certificates using aliyun.
Certbot Dns Hetzner	101			3 months ago	6	November 27, 2020		other	Python
Certbot plugin enabling dns-01 challenge on the Hetzner DNS API
Certbot External Auth	92	3	1	2 years ago	11	April 08, 2020	6	other	Python
Certbot external DNS, HTTP, TLSSNI domain validation plugin with JSON output and scriptable hooks, with Dehydrated compatibility
Certbot Dns Inwx	85			5 months ago	3	March 06, 2021	6	apache-2.0	Python
INWX DNS authenticator plugin for certbot
Netbox Ddns	78			2 months ago	18	May 25, 2022	4	apache-2.0	Python
Dynamic DNS Connector for NetBox
Ads	71			2 years ago	12	August 02, 2021	5	apache-2.0	Go
CoreDNS plugin to block ads. Inspried by PiHole.
Dnsredir	71		1	24 days ago	13	January 05, 2022	5	apache-2.0	Go
Yet another seems better forward/proxy plugin for CoreDNS