Install naisdevice

Warning

The issues reported by Kolide must be addressed - these remediations have been vetted by the Nais team and should be followed. Depending on the issue, you might lose naisdevice connectivity if an issue is left unresolved for a sufficient length of time.

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.

Device-specific installation steps

macOSWindows (Scoop)Winows (Manual)Ubuntu

1. Go here, log in, and follow the prompts.

   1. If Kolide reports any issues, follow the instructions on how to remediate them. If a remediation required by Kolide makes you feel unsafe - feel free to ask in #naisdevice Slack channel.

2. Install Homebrew unless you already have it.

3. Run these commands in a terminal

   brew tap nais/tap
   brew install naisdevice
   

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

5. Turn on your freshly installed naisdevice app.

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

1. Go here, log in, and follow the prompts.

   1. If Kolide reports any issues, follow the instructions on how to remediate them. If a remediation required by Kolide makes you feel unsafe - feel free to ask in #naisdevice Slack channel.

2. Install Scoop unless you already have it.

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

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

4. 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)

5. Start naisdevice from the Start menu

1. Go here, log in, and follow the prompts.

   1. If Kolide reports any issues, follow the instructions on how to remediate them. If a remediation required by Kolide makes you feel unsafe - feel free to ask in #naisdevice Slack channel.

2. Go to github.com/nais/device.

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

1. Go here, log in, and follow the prompts.

   1. If Kolide reports any issues, follow the instructions on how to remediate them. If a remediation required by Kolide makes you feel unsafe - feel free to ask in #naisdevice Slack channel.

2. Install curl

   sudo apt install curl
   

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

4. Install the naisdevice package:

   sudo apt install naisdevice
   

5. Find naisdevice in your application menu, or use the naisdevice command in a terminal to start the application.

Connect naisdevice through task/sys -tray icon

When you have opened naisdevice the naisdevice icon appears 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).
2. Can't find the icon? Make sure it is installed (See macOS, Windows (Scoop) or Ubuntu)
3. Left-click it and select Connect.
4. Left-click the naisdevice icon again and click Connect.
5. You might need to allow ~20 seconds to pass before clicking Connect turns your naisdevice icon green.