# What is Nokku?

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

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

```bash
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](/docs/learn/ssh-basics) explains it from zero.

## The three pieces

```mermaid
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](/docs/self-hosting/deploy), 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](/docs/servers/without-daemon).

The SSH connection goes from your laptop straight to the server, not through the core. See [What happens when you type ssh](/docs/learn/connecting).

## 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

- **Setting Nokku up?** Follow the [Quickstart](/docs/getting-started/quickstart).
- **Someone invited you?** [Connect to servers](/docs/getting-started/connect) is all you need.
- **Running your own instance?** Start with [Deploy the core](/docs/self-hosting/deploy).
