naisdevice how-to

Install naisdevice

Warning

To make sure you are using naisdevice as securely as possible, make sure you are a member of the Slack channel #naisdevice. Important information will be published there. This also where you find us, if you need any help.

Prerequisites

Note

On first time connection you will be presented with soft policies (aka. Do's & Don'ts)

Device-specific installation steps

The Kolide agent will be added to your Slack app, and let you know when there are recommended updates or security issues you need to address - and how to address them. They have been vetted by the Nais team and should be followed to keep your device safe.

  1. Install Homebrew unless you already have it.

Homebrew makes it possible to install and maintain apps using the terminal app on your Mac.

  1. Open terminal (Use <Command> + <Space> to find Terminal.app) and add the nais tap by typing or pasting the text below and press <Enter>.

Adding the nais tap lets Homebrew know where to get and update files from. Do not worry about where it will be installed, we got you covered.

bash
bash

  1. You will be asked for your local device account's password to finish the installation.

    1. The password is not accepted unless you have administrator privileges, so you need to get that first.
    2. If you're running a NAV Mac: Open your Privileges.app (Use <Command> + <Space> to find the Privileges.app and request privileges. When this is done, you can enter your password in terminal. The privileges last 10 minutes. The limited time is due to security reasons, because we know many of us forget to turn it off afterwards.

  2. Turn on your freshly installed naisdevice app.

  3. Use <Command> + <Space> to find your naisdevice.app and press <Enter>.

The Kolide agent will be added to your Slack app, and let you know when there are recommended updates or security issues you need to address - and how to address them. They have been vetted by the Nais team and should be followed to keep your device safe.

  1. Install Scoop unless you already have it.
powershell
powershell
  1. When the bucket is added, you are ready to install naisdevice, by typing the following in the command line:
powershell

(you will be asked for administrator access to run the installer)

  1. Start naisdevice from the Start menu

Install Kolide agent.

The Kolide agent will be added to your Slack app, and let you know when there are recommended updates or security issues you need to address - and how to address them. They have been vetted by the Nais team and should be followed to keep your device safe.

  1. Open a browser.
  3. Download and run the newest naisdevice.exe installer (you will be asked for administrator access when you run the installer).
  4. Start naisdevice from the Start menu.

Warning

Using Gnome DE on latest Ubuntu LTS - only supported variant atm

Install curl

NOTE curl is not installed in a "fresh" ubuntu:

Plaintext

Add the nais PPA repo:

Plaintext

Install the naisdevice package:

Plaintext

Warning

On first time connection you will be presented with soft policies (aka. Do's & Don'ts)

Connect naisdevice through task/sys -tray icon

A macOS systray exemplifying a red-colored `naisdevice` icon.

When you have opened naisdevice, you may be concerned that nothing happened. The little naisdevice icon has appeared in your Systray (where all your small program icons are located - see above picture for how it looks on Mac):

  1. Find your naisdevice icon (pictured above - though it should not be red at first attempted connection).
  2. Left-click it and select Connect.
  3. Left-click the naisdevice icon again and click Connect.
    • You might need to allow ~20 seconds to pass before clicking Connect turns your naisdevice icon green.