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.
- Install Homebrew unless you already have it.
Homebrew makes it possible to install and maintain apps using the terminal app on your Mac.
- Open terminal (Use
<Command> + <Space>
to findTerminal.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.
-
When the tap is added, you are ready to install naisdevice, by typing or pasting the following in terminal and press
<Enter>
. -
You will be asked for your local device account's password to finish the installation.
- The password is not accepted unless you have administrator privileges, so you need to get that first.
- If you're running a NAV Mac: Open your
Privileges.app
(Use<Command> + <Space>
to find thePrivileges.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.
-
Turn on your freshly installed
naisdevice
app. - Use
<Command> + <Space>
to find yournaisdevice.app
and press<Enter>
. - Follow the instructions to connect your nais device.
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.
-
Install Scoop unless you already have it.
-
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.
-
When the bucket is added, you are ready to install naisdevice, by typing the following in the command line:
(you will be asked for administrator access to run the installer) -
Start naisdevice from the Start menu
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.
- Open a browser.
- Go to github.com/naid/device.
- Download and run the newest
naisdevice.exe
installer (you will be asked for administrator access when you run the installer). - Start naisdevice from the Start menu.
Warning
Using Gnome DE on latest Ubuntu LTS - only supported variant atm
- 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
NOTE curl is not installed in a "fresh" ubuntu:
- Install the naisdevice package:
- Turn on your freshly installed
naisdevice
application. - Find
naisdevice
in your application menu, or use thenaisdevice
command in a terminal to start the application. - Follow the instructions to connect your nais device.
Warning
On first time connection you will be presented with soft policies (aka. Do's & Don'ts)
Connect naisdevice through task/sys -tray 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):
- Find your
naisdevice
icon (pictured above - though it should not be red at first attempted connection).- Can't find the icon? Make sure it is installed (See macOS, Windows (Scoop) or Ubuntu)
- Left-click it and select
Connect
. - Left-click the
naisdevice
icon again and clickConnect
.- You might need to allow ~20 seconds to pass before clicking
Connect
turns yournaisdevice
icon green.
- You might need to allow ~20 seconds to pass before clicking