> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uselumina.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Configure the Lumina SDK for your environment

Configure the Lumina TypeScript/JavaScript SDK.

***

## Basic Configuration

```typescript theme={null}
import { initLumina } from '@uselumina/sdk';

const lumina = initLumina({
  endpoint: 'http://localhost:9411/v1/traces',
  service_name: 'my-service',
});
```

***

## Configuration Options

| Option         | Type    | Required | Description                            |
| -------------- | ------- | -------- | -------------------------------------- |
| `endpoint`     | string  | Yes      | OTLP trace endpoint URL                |
| `service_name` | string  | Yes      | Service identifier                     |
| `enabled`      | boolean | No       | Enable/disable tracing (default: true) |
| `resource`     | object  | No       | Additional resource attributes         |

***

## Environment-Based Configuration

```typescript theme={null}
const lumina = initLumina({
  endpoint: process.env.LUMINA_ENDPOINT,
  service_name: process.env.SERVICE_NAME,
  enabled: process.env.NODE_ENV === 'production',
});
```

***

## Resource Attributes

```typescript theme={null}
const lumina = initLumina({
  endpoint: 'http://localhost:9411/v1/traces',
  service_name: 'my-service',
  resource: {
    environment: 'production',
    version: '1.2.0',
    region: 'us-east-1',
  },
});
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Basic Usage" href="/docs/sdk/typescript/basic-usage">
    Learn basic tracing patterns
  </Card>

  <Card title="API Reference" href="/docs/sdk/typescript/api-reference">
    Complete API documentation
  </Card>
</CardGroup>