# 03 User Management

## Create a user

```
nf user add <username>
```

Creates a user with a randomised initial login token. The token will be provided in the command output, and you can pass this on to the user for use on their first login.

```
nf user add <username> --initial-token <token>
```

Creates a user with a manually set initial login token. 

```
nf user add <username> --no-token
```

Creates a user with no initial login token. This means that the server will accept the first login to the user account with minimal checks. **Use this option with caution.**

## List Users

```
nf user list [-p <page>] [-s <pageSize>] [--search <search terms>]
```

```
nf user ls [-p <page>] [-s <pageSize>] [--search <search terms>]
```

Lists the configured users along with their creation and last login times.

You can use the standard page, page size and search parameters.

## Set a Password

> This functionality is not guarateed to exist prior to version 1.0, and is subject to change.

```
nf user password <user> <password>
nf user password <user> --random
```
```
nf user pw <user> <password>
nf user pw <user> --random
```

Command line users do not need passwords, instead relying on keyfiles. You can, however, set a password for a user, which will allow them to log in to the web interface.

This has no bearing on command line users.

## Delete a user

```
nf user delete <username>
```

Deletes the specified user.