# Command-line interface

Dexi release commands are run through the release executable, usually `bin/dexi`.

## Database migrations

```sh
bin/dexi migrate
```

Runs all pending database migrations. Run this command after deploying a release that contains new migrations.

For local development, use:

```sh
mix ecto.migrate
```

## Create or promote an administrator

```sh
bin/dexi admin --create <pubkey>
```

Creates an administrator with the supplied public key. If the user already exists, their role is changed to `admin`. Running the command more than once is safe.

For local development, use:

```sh
mix dexi.admin --create <pubkey>
```

## Remove administrator access

```sh
bin/dexi admin --remove <pubkey>
```

Changes the existing user's role from `admin` to `user`. The user account and profile information are preserved.

For local development, use:

```sh
mix dexi.admin --remove <pubkey>
```

## Create test users

```sh
bin/dexi test_users --count <count>
```

Creates the requested number of test users with generated public keys, names, and email addresses. A single invocation accepts between 1 and 10,000 users.

Production releases disable this command by default. Set `DEXI_ALLOW_TEST_USERS=true` only when synthetic users are intentionally required.

For local development, use:

```sh
mix dexi.test_users --count <count>
```