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.
- 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.
-
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.
- Install Scoop unless you already have it.
Scoop makes it possible to install and maintain programs from the command line.
- 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)
- If you need to connect to anything running in K8s cluster, remember to update your kubeconfig
- Start naisdevice from the Start menu
Manual installation¶
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.
- Download and install naisdevice.exe (you will be asked for administrator access when you run the installer)
- Start naisdevice from the Start menu
-
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
-
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.
- 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)