io7m | single-page | multi-page | epub | Idstore User Manual 1.1.0
6.1. Overview
Previous
6. Command-Line Interface
Up
6.3. server
Next

# 6.2. initial-admin

- 6.2.1. Name
- 6.2.2. Description
- 6.2.3. Examples

## 6.2.1. Name

1
initial-admin - Initialize the server

## 6.2.2. Description

1
The initial-admin command creates or updates the initial administrator.
2
If the initial administrator does not exist, it is created and assigned the given names, email address, and password. If an administrator already exists with the given ID and is the initial administrator, it is updated with the given names, email address, and password. Otherwise, if the administrator exists but is not the initial administrator, the command fails with an error.

### 6.2.2.3. Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--configuration | Path | true | The configuration file
--admin-id | UUID | true | The ID of the initial administrator
--admin-username | String | true | The initial administrator to create.
--admin-password | String | true | The password of the initial administrator.
--admin-email | String | true | The email address of the initial administrator.
--admin-realname | String | true | The real name of the initial administrator.
--verbose | CLPLogLevel | false | Set the minimum logging verbosity level.

## 6.2.3. Examples

### 6.2.3.1. Example

    $ idstore initial-admin \
      --admin-id '92f83bce-3973-4db8-8aaf-d401443a9772' \
      --admin-email 'someone@example.com' \
      --admin-realname 'Someone Else' \
      --admin-username 'someone' \
      --admin-password 12345678 \
      --configuration server.conf

6.1. Overview
Previous
6. Command-Line Interface
Up
6.3. server
Next
io7m | single-page | multi-page | epub | Idstore User Manual 1.1.0