---
title: init
description: Validate credentials and prepare a first observation from a website.
canonical_url: https://orchestor.io/docs/en/cli/init
markdown_url: https://orchestor.io/docs/en/cli/init.md
contentType: reference
---

# init

`orc init` validates and saves credentials and checks Workspace connectivity. With `--website`, it generates observation configuration from a site, confirms it, and waits for the first batch to complete.

The first observation requires an existing account and Workspace access. It reuses saved browser authentication or an API key and does not create an account or Workspace. See [CLI onboarding](https://orchestor.io/docs/cli/workflows/onboarding.md) for the complete workflow.

## Usage

```bash title="terminal"
printf '%s' "$ORCHESTOR_API_KEY" | orc init
```

*Validate an API key from standard input and initialize the CLI.*

## Unique options

### `--website`

Website to onboard (waits through confirmation and the first batch)

Type: `string`. Optional.

```bash title="terminal"
orc init --website <value>
```

### `--region`

Observation region (API default: JP)

Type: `string`. Optional.

```bash title="terminal"
orc init --region <value>
```

### `--language`

Observation language (API default: ja)

Type: `string`. Optional.

```bash title="terminal"
orc init --language <value>
```

### `--no-confirm`

Stop after extraction to review and edit before confirmation

Type: `boolean`. Optional.

```bash title="terminal"
orc init --no-confirm
```

### `--api-key`

API key (deprecated; pipe via standard input instead)

Type: `string`. Optional.

```bash title="terminal"
orc init --api-key <value>
```

## Examples

### Run from website setup through the first observation.

```bash title="terminal"
orc init --website https://example.com --workspace <workspace-id> --timeout 10m
```

*Run from website setup through the first observation.*

### Stop after generation for review.

```bash title="terminal"
orc init --website https://example.com --workspace <workspace-id> --no-confirm
```

*Stop after generation for review.*

## Observation configuration and waiting

`--region` and `--language` select the observation region and language. When omitted, the API defaults are `JP` and `ja`. Select the target with `--workspace`.

`--website` waits even without `--wait`. Set a limit such as `10m` with `--timeout`; there is no default wait limit. `--poll-interval` defaults to `5s`. `--json` returns structured results.

If connectivity fails after configuration was saved, the saved settings remain. Check the target and authentication before retrying.

After interruption or timeout, check the current state using the displayed setup or batch status commands. Use `--no-confirm` to edit before confirmation and continue with the [stepwise first observation guide](https://orchestor.io/docs/cli/workflows/onboarding.md).

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc init`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--wait`](https://orchestor.io/docs/cli/global-flags.md)
- [`--timeout`](https://orchestor.io/docs/cli/global-flags.md)
- [`--poll-interval`](https://orchestor.io/docs/cli/global-flags.md)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)