Skip to content
Nokku LogoNokku
GuidesLearn the concepts

What Nokku does, the three pieces it is made of, and where to start reading.

Last updated on

Nokku decides who can log in to which server, and then gets out of the way. Your team keeps using the normal ssh command:

nk login           # opens your browser, once
ssh deploy@web-1   # the ssh you already know

Behind that, Nokku replaces copied SSH keys with certificates. A certificate is a short-lived pass that names its owner and expires by itself. Nobody copies keys to servers, and nobody hunts them down when a colleague leaves. New to this? How it works explains it from zero.

The three pieces

flowchart LR
  nk["<b>nk</b><br>on your laptop"]
  core["<b>Nokku core</b><br>the control plane"]
  daemon["<b>nokkud</b><br>on each server"]
  nk -- "sign in, get certificates" --> core
  core -- "access lists, pushed live" --> daemon
  nk == "ssh" ==> daemon
  • The core stores who may access what and signs the certificates. You use it through the web app. Run it yourself, for free. A hosted version comes later.
  • nk is the command-line tool on your laptop. You sign in once, and it fetches certificates and sets up ssh for you.
  • nokkud is a daemon on each server. It checks certificates, gets access changes right away, and can record sessions. It is optional, see Servers without the daemon.

The SSH connection goes from your laptop straight to the server, not through the core. See What happens when you type ssh.

The words you will see

  • Workspace: your team’s space in Nokku. It holds servers, people and settings.
  • Server: a machine you manage with Nokku. The API calls it a target.
  • User: a person in your workspace. A service account is the same for a script or CI job.
  • Linux account: an account on a server, like ubuntu or root.
  • Grant: the permission for a user or team to log in to one server as one Linux account.
  • Role: what a user may do in the web app, from member to owner. Roles open no server.
  • Team: a named group of users. A grant to a team covers every member.
  • Certificate authority (CA): the key that signs certificates. Every workspace has one.
  • Enroll token: the secret a new server uses to join your workspace.
  • Relay: the encrypted path through the core to a server that can’t be reached directly.

Where to go next