open-nomad/website/source/docs/http/sys-init.html.md
2015-09-17 16:33:37 -07:00

1.3 KiB

layout page_title sidebar_current description
http HTTP API: /sys/init docs-http-sys-init The '/sys/init' endpoint is used to initialize a new Nomad.

/sys/init

GET

Description
Return the initialization status of a Nomad.
Method
GET
Parameters
None
Returns
```javascript
{
  "initialize": true
}
```

PUT

Description
Initializes a new Nomad. The Nomad must've not been previously initialized.
Method
PUT
Parameters
  • secret_shares required The number of shares to split the master key into.
  • secret_threshold required The number of shares required to reconstruct the master key. This must be less than or equal to secret_shares.
Returns
A JSON-encoded object including the master keys and initial root token:
```javascript
{
  "keys": ["one", "two", "three"],
  "root_token": "foo"
}
```