Install it

We will use Docker to Install this wonderfully beautiful piece of front end software.  First, let's make a folder to hold the application definition files.

mkdir /tmp/webmap

Now we want to use docker to create our container that will run the web front end.

docker run -d \
    --name webmap \
    -h webmap \
    -p 8000:8000 \
    -v /tmp/webmap:/opt/xml \
    reborntc/webmap

You may need to change the left side of the port mapping if your host machine already has 8000 in use by another application or process.

When you run the command above, it may take a while, and the whole thing is near 1 GB of space...just be aware of that.

Once it's up and running, you want to run an NMap command to get an XML file generated and place in the folder we created.

nmap -sT -A -T4 -oX /tmp/webmap/myscan.xml 192.168.1.0/24

NOTE: On the above command, you need to enter the IP address range for your network.  For instance, my network is not 192.168.1.x, but 192.168.7.x so I had to change the command to look like this:

nmap -sT -A -T4 -oX /tmp/webmap/myscan.xml 192.168.7.0/24

I don't have nmap installed?

Not to worry, you can install nmap with the following command on Debian / Ubuntu based distros:

sudo apt install nmap -y

On Fedora / Centos, you can use

sudo dnf install nmap -y

Once installed, just run the command above on the host machine where you are running WebMap.

While the command is running for nmap, we can grab a token for our login:

docker exec -ti webmap /root/token

This will give us a token int he terminal, and we'll use that token when we login to our WebMap user interface the first time.

The NMap command is long running (about 10 minutes or so), but when it's done, you can load up your host IP at the port your set on the left side of the docker command.  For me it was

http://192.168.7.125:8000

Enter the Token we got above, and you can see the interface to help you analyze and idnetify any issues on your network.