---
title: "nctl login nch"
diataxis: reference
applies_to:
  product: "nctl"
audience: ["developer","platform-engineer"]
last_updated: 2026-04-16
url: https://docs.nirmata.io/docs/nctl/commands/nctl_login_nch/
---

## nctl login nch

Sign in to Nirmata Control Hub

```bash
nctl login nch [flags]
```

### Examples

```bash

  # Login to Nirmata Control Hub using an email and API key
  nctl login nch --userid user@example.com --token my-api-key

  # Login to Nirmata using a specific server URL
  nctl login nch --userid user@example.com --token my-api-key --url https://nirmata.example.com

  # Login using a configuration file
  nctl login nch --file /path/to/config.yaml

  # Login interactively (prompt for email and API key)
  nctl login nch

```

### Options

```text
  -f, --file string     the configuration file (defaults to $HOME/.nirmata/config)
  -h, --help            help for nch
      --insecure        allow connection to a Nirmata server with a insecure certificate (not recommended)
      --token string    the Nirmata API Login Key (env NIRMATA_TOKEN)
      --url string      the Nirmata server base URL (env NIRMATA_URL)
      --userid string   user id (email)
```text

### Options inherited from parent commands

```text
  -v, --v Level   number for the log level verbosity
```

### SEE ALSO

* [nctl login](nctl_login.md)	 - Provide authentication details to login