# noust variables

Variables shared by the server, a team, a project or an environment.

```bash
noust variables [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`list`](#noust-variables-list), [`set`](#noust-variables-set), [`unset`](#noust-variables-unset), [`used-by`](#noust-variables-used-by)

## noust variables list

List the variables of a scope, secrets hidden.

```bash
noust variables list [OPTIONS] {server|team|project|environment}
```

Arguments: `scope`

| Option | What it does | Default |
|---|---|---|
| `--team` | The team. |  |
| `--project` | The project. |  |
| `--environment` | The environment. |  |
| `--unmask` | Print secret values in clear. |  |
| `--json` | Print the variables as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust variables set

Create or change a shared variable.

```bash
noust variables set [OPTIONS] {server|team|project|environment} NAME
                           [VALUE]
```

Arguments: `scope`, `name`, `value`

| Option | What it does | Default |
|---|---|---|
| `--team` | The team. |  |
| `--project` | The project. |  |
| `--environment` | The environment. |  |
| `--stdin` | Read the value from standard input (not argv). |  |
| `--secret`, `--not-secret` | Say whether it is a secret. |  |
| `--audience` | Which part of a deployment an application that uses it hands it to. | `both` |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust variables unset

Remove shared variables.

```bash
noust variables unset [OPTIONS] {server|team|project|environment}
                             NAMES...
```

Arguments: `scope`, `names`

| Option | What it does | Default |
|---|---|---|
| `--team` | The team. |  |
| `--project` | The project. |  |
| `--environment` | The environment. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust variables used-by

List the applications whose variables refer to a shared variable.

```bash
noust variables used-by [OPTIONS] {server|team|project|environment}
                               NAME
```

Arguments: `scope`, `name`

| Option | What it does | Default |
|---|---|---|
| `--team` | The team. |  |
| `--project` | The project. |  |
| `--environment` | The environment. |  |
| `--json` | Print the applications as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |