---
title: init
description: Set up a new Treeship trust domain.
---

import { Callout } from 'fumadocs-ui/components/callout';

## Usage

```bash
treeship init [OPTIONS]
```

## What it does

Creates a new Treeship with:
- An optional name
- A new Ed25519 keypair, encrypted at rest

<Callout type="info">
No account, no email, no network connection required. Everything is generated locally.
</Callout>

## Example

```bash
treeship init
```

```
✓ Treeship initialized
  name: my-workspace
  key:  key_9f8e7d6c (ed25519, encrypted at rest)
```

## Options

| Option | Description |
|--------|-------------|
| `--name <name>` | Treeship name (optional) |
| `--force` | Overwrite an existing config |
| `--config <path>` | Config file path |

## Non-interactive

```bash
treeship init --name ci-ship
```

Useful for CI environments where interactive prompts are not available.

## What gets created

```
~/.treeship/
└── config.json       # Treeship configuration
└── keystore/         # Encrypted Ed25519 keypair
└── artifacts/        # Local artifact store
```
