# Initial Configuration Guide

Configure Provisioning for first-time use.

## Environment Setup

```bash
export PROVISIONING_HOME=~/.provisioning
export PROVISIONING_LOG_LEVEL=info
export PROVISIONING_CONFIG_PATH=~/.config/provisioning
```

## Initialize Installation

```bash
provisioning init --interactive
```

This creates:
- `~/.provisioning/` - Working directory
- `~/.config/provisioning/` - Configuration
- `~/.provisioning/workspaces/` - Workspace storage

## Configure Cloud Providers

### AWS

```bash
aws configure --profile provisioning

provisioning provider config aws \
  --profile provisioning \
  --region us-east-1
```

### UpCloud

```bash
provisioning provider config upcloud \
  --username [user@example.com](mailto:user@example.com) \
  --api-password "$UPCLOUD_API_PASSWORD"
```

### Hetzner

```bash
provisioning provider config hetzner \
  --token "$HCLOUD_TOKEN"
```

## Create First Workspace

```bash
provisioning workspace create production \
  --description "Production infrastructure"
```

## Initialize Secrets Vault

```bash
provisioning vault init

# Store initial credentials
provisioning vault add db_password "secure-password-123"
```

## Related Documentation

- [Getting Started](../getting-started/README.md)
- [Installation Guide](../getting-started/installation.md)
- [Quick Start](../getting-started/quick-start.md)
