# macOS instructions

## MacOS NVIS Alert GUI Instructions

Overview 

The NVIS App is a dock icon app that allows you to do all NVIS commands without having to use the Terminal shell. CLI. The app is loaded from a disk image (DMG) file. 

The mapping to NVIS commands is reflected in this table:  

| Button          | CLI                               | Privilege |
| --------------- | --------------------------------- | :-------: |
| Install/ Update | (nvis\_macos\_inst install equiv) |     ✓     |
| About           | nvis -v                           |           |
| Reload          | nvis\_macos\_inst refresh         |     ✓     |
| Set Address     | nvis -ga \<addr>                  |     ✓     |
| Settings        | nvis -gl                          |           |
| NVIS IP         | nvis -s                           |           |
| ON              | nvis on                           |     ✓     |
| OFF             | nvis off                          |     ✓     |

## Quickstart

There are two versions of NVIS for Mac. NVIS App is the latest for M1/M2/M3 (arm64), and x86\_64 (Universal). Which you could run with Rosetta.

Either can be downloaded from[ ](https://nvis-inc.com/download)<https://nvis-inc.com/download>as DMG files.

Other than that, the attached instructions are the same for both.

The Quick Start is:

1. Download the arm64 or x86\_64 DMG
2. Click on DMG and it will mount the Installer. Launch it.
3. The installer lets you drag and drop NVIS to the Applications folder.
4. Double Click the NVIS App

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2F4StIbPgacFleAc4enEIO%2FSecond%20Installation.png?alt=media&#x26;token=c7e31581-c53d-4dab-ad09-2891931ecf05" alt="" width="251"><figcaption></figcaption></figure>

&#x20;    If you come across this message on your mac then go to&#x20;

&#x20;               a. System settings > Privacy and security           &#x20;

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FtYzAOLx0dvNO86PFr3ze%2FScreenshot%202025-01-30%20at%209.56.13%E2%80%AFAM.png?alt=media&#x26;token=2a9b58a1-fb9e-4104-8138-d7c94a18f0a4" alt=""><figcaption></figcaption></figure>

&#x20;            b. Press the button "Open Anyways"&#x20;

&#x20;            c. Enter Password  &#x20;

&#x20;5\. Now when you Launch NVIS You will see:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FoNmAelN7QO5hvgXgxuyS%2FScreenshot%202024-10-06%20at%209.31.30%E2%80%AFPM.png?alt=media&#x26;token=bae6aa47-d12a-4dad-b318-5b89ccafc1b0" alt=""><figcaption></figcaption></figure>

5. Press Install/Update. It will prompt you for the Admin password.
6. After rebooting, launch NVIS again. Press “Set Address” for your license. Here’s a demo license:

&#x20;        0x3b8a8ba0de39184c85c2a3d176acbac6eabb0e20

&#x20;       Press OK. It will promote you for the Admin password to save it.&#x20;

&#x20;  9\.  Now it gets easy. You can press: Settings to see your NVIS IP.&#x20;

&#x20; 10\. If all is well, you can press ON.&#x20;

&#x20; 11\. To test, you can click on this URL  <http://10.0.1.65/>You should still see Paris

App Installation

1. Download DMG file: “NVIS App Install \<arm64, x86\_64>.dmg”
2. From the desktop double click the DMG. You will see:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FYbngUIh4n6sREfCxfVUE%2FScreenshot%202024-10-06%20at%2010.16.43%E2%80%AFPM.png?alt=media&#x26;token=715ed3b1-6f26-4ffc-a7d5-f8a1d57c11b0" alt=""><figcaption></figcaption></figure>

3. Double click and you will see:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FBNIIeyAjyUWDmPKDKG3e%2FScreenshot%202024-10-06%20at%2010.17.51%E2%80%AFPM.png?alt=media&#x26;token=24fd33d8-d70e-41c4-a0df-c20d89744256" alt=""><figcaption></figcaption></figure>

4. Drag the **NVIS** icon to the Applications folder.
5. You should now see the NVIS icon in your Applications and in the Launchpad&#x20;

Click the app and you will see:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FwNjjyq95GFs3kBKW588E%2FScreenshot%202024-10-06%20at%2010.20.24%E2%80%AFPM.png?alt=media&#x26;token=7c18a2b3-eebd-4fde-b677-cb5697f3f6b4" alt=""><figcaption></figcaption></figure>

## Setup and Operation

The NVIS App buttons organized in the order of use:&#x20;

• Install/Update – installs or updates the NVIS CLI and drivers.&#x20;

• About – to verify the version of the installed software.&#x20;

• Reload drivers after a power oT or cold-boot.&#x20;

• Set Address – This is the “who am I “ query to the SDP using the assigned User Address for your node. It also let’s you change your identity.&#x20;

• Settings – show the Group, NVIS IP for the User Address.&#x20;

• NVIS IP – just show the secure IP address of your machine.&#x20;

• ON – connects to your network segment / group&#x20;

• OFF – disconnect from your group

The normal operation is just ON/OFF.

## Install/Update

This button installs or updates the underlying NVIS commands and drivers.

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2F9GupVEhrRnj3XYQkuz2z%2FScreenshot%202024-10-06%20at%2010.25.00%E2%80%AFPM.png?alt=media&#x26;token=177e5a79-6b9f-47d8-9e1e-f3a5a00bf744" alt=""><figcaption></figcaption></figure>

**NOTE**: First time installation requires you to go to System Settings to enable the app, and Privacy and Security to enable third party driver load, then **REBOOT** to load the drivers.

## About&#x20;

This returns the version and platform info:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FllEohGdbPK1iE5326hdo%2FScreenshot%202024-10-06%20at%2010.27.24%E2%80%AFPM.png?alt=media&#x26;token=f80e67fb-2fb4-4c92-a600-c0cfdcb67eed" alt=""><figcaption></figcaption></figure>

## Set Address

You first must do a “who am I” query to get your assigned group, network and security information for your unique address.

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FZmSrLOurdr0CdgxwLIXM%2FScreenshot%202024-10-06%20at%2010.28.45%E2%80%AFPM.png?alt=media&#x26;token=1c0d260e-74d4-4148-b214-830684c53720" alt=""><figcaption></figcaption></figure>

## NVIS IP

This button shows the current IP

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FbdSfuuiJX5TazqfA6qCk%2FScreenshot%202024-10-06%20at%2010.30.08%E2%80%AFPM.png?alt=media&#x26;token=e0732c0c-abc2-4bd8-bf6b-7eda3482b7fa" alt=""><figcaption></figcaption></figure>

## Settings

This command gets configuration. First time shows the NVIS IP on the main window. Clicking it again shows all details.

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2F0DjgBtOglEZL8rIsEhxZ%2FScreenshot%202024-10-06%20at%2010.31.16%E2%80%AFPM.png?alt=media&#x26;token=547dbd29-bab8-4602-82d1-70c4925b9ea3" alt=""><figcaption></figcaption></figure>

The details consist of:&#x20;

• Group name&#x20;

• NVIS IP&#x20;

• User (Universal Unique Address)

## ON

The ON button connects to the NVIS network. This requires Administrator (sudo) privileges, so a dialog will pop-up:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FmdWDn79DmdOrEyZ22JDh%2FScreenshot%202024-10-06%20at%2010.33.45%E2%80%AFPM.png?alt=media&#x26;token=c512cdab-427d-46d5-b685-5003165c861b" alt=""><figcaption></figcaption></figure>

You may verify this in a Terminal window by pinging your own NVIS IP:

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FNmT2FHcHZop58qtXdCM0%2FScreenshot%202024-10-06%20at%2010.35.09%E2%80%AFPM.png?alt=media&#x26;token=27981ee1-1861-4654-82c6-836daf12f170" alt=""><figcaption></figcaption></figure>

## OFF

The OFF button will disconnect from the NVIS network. It also requires Administrator (sudo) privileges. After running it, if you have a Terminal window running ping, you will see that it times out until you press ON.

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FpzGevc5lNXEbHIkiJPKI%2FScreenshot%202024-10-06%20at%2010.36.17%E2%80%AFPM.png?alt=media&#x26;token=6c35399e-100f-4616-b95d-4f8087f20683" alt=""><figcaption></figcaption></figure>

<figure><img src="https://307139011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhXpA1kXn0GpvG0nUq4uR%2Fuploads%2FLbTvNBIqAHBuMM1M1qyd%2FScreenshot%202024-10-06%20at%2010.37.14%E2%80%AFPM.png?alt=media&#x26;token=bb0b9763-adcc-42a6-ba83-0fdad77c3119" alt=""><figcaption></figcaption></figure>

## Reload

This button reloads the network device drivers. This may be needed after a power-oT or reboot.

## **Command Line Interface**

## Installer&#x20;

NVIS includes a command line installer, nvis\_macos\_inst .&#x20;

## Install/Update&#x20;

The CLI option to install is:

**nvis\_macos\_inst install**&#x20;

## Uninstall&#x20;

The CLI option to remove the installation is:&#x20;

**nvis\_macos\_inst uninstall**&#x20;

## Reload drivers&#x20;

After a power oT / shutdown or cold—boot, the drivers may need to be reloaded. This can be done by the command::&#x20;

**nvis\_macos\_inst refresh**

After “Install” from the App or CLI, the following command line interface (CLI) utilities are provided:&#x20;

nvis

Options:

nvis on                      Connect to the network.

nvis off                      Disconnect from the network&#x20;

nvis -s                       Gets the current connection status&#x20;

nvis -h                       Program Help&#x20;

nvis -v                       NVIS Version&#x20;

nvis -ga addr          Add a new group identity&#x20;

nvis -gl                     List groups

## Popular Commands

### Who Am I

You may set or change your identity via the command “nvis -ga”, for example:&#x20;

**nvis -ga 0xfb3b587728da03c540b3c124b193369c1271c421**&#x20;

### Show Current NVIS IP&#x20;

You may see your current NVIS IP using the show command:&#x20;

**nvis –s**&#x20;

### List Group Settings&#x20;

The current group settings (gGoup, NVIS IP and Address) can be seeing via this command:&#x20;

**nvis -gl**

### ON

Connect to the NVIS network. For your group/segment is easy:&#x20;

**nvis on**&#x20;

### OFF&#x20;

Disconnect from your group/segment:&#x20;

**nvis off**