Skip to content

Install naisdevice

Prerequisites

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.

brew tap nais/tap
  1. When the tap is added, you are ready to install naisdevice, by typing or pasting the following in terminal and press <Enter>.
brew install naisdevice
  1. You will be asked for your local device account's password to finish the installation.
  2. The password is not accepted unless you have administrator privileges, so you need to get that first.

  3. 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.

  4. Turn on your freshly installed naisdevice app.

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

  6. Follow the instructions to connect your nais device.

  7. If you need to connect to anything running in K8s cluster, remember to update your kubeconfig

Install using Scoop

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.

Scoop makes it possible to install and maintain programs from the command line.

  1. Use the following command in the command line to add the nais bucket to let Scoop know where to get and update files from. Do not worry about where it will be installed, we got you covered. 
    scoop bucket add nais https://github.com/nais/scoop-bucket
  2. When the bucket is added, you are ready to install naisdevice, by typing the following in the command line: 
    scoop install naisdevice
    (you will be asked for administrator access to run the installer)
  3. If you need to connect to anything running in K8s cluster, remember to update your kubeconfig
  4. Start naisdevice from the Start menu

Manual installation

  1. 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. Download and install naisdevice.exe (you will be asked for administrator access when you run the installer)
  2. Start naisdevice from the Start menu

  1. Add the nais PPA repo: 

    NAIS_GPG_KEY="/etc/apt/keyrings/nav_nais_gar.asc"
curl -sfSL "https://europe-north1-apt.pkg.dev/doc/repo-signing-key.gpg" | sudo dd of="$NAIS_GPG_KEY"
echo "deb [arch=amd64 signed-by=$NAIS_GPG_KEY] https://europe-north1-apt.pkg.dev/projects/nais-io nais-ppa main" | sudo tee /etc/apt/sources.list.d/nav_nais_gar.list
sudo apt update

  2. Install the naisdevice package: 

    sudo apt install naisdevice

  3. Turn on your freshly installed naisdevice application.
  4. Find naisdevice in your application menu, or use the naisdevice command in a terminal to start the application.
  5. Follow the instructions to connect your nais device.
  6. Remember to update your kubeconfig.

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.

Note

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