# Configuration System {#configuration-system}


How Gauzy manages environment-based configuration across all modules.


## Overview {#overview}


Gauzy uses a layered configuration approach:





```mermaid
graph TB
    A[Environment Variables] --> B[ConfigModule]
    B --> C[Feature-specific Config]
    C --> D[Runtime Configuration]
    A --> E[.env File]
    E --> B
```






## ConfigModule {#configmodule}


NestJS `@nestjs/config` module for centralized configuration:

```typescript
@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,
      envFilePath: ".env",
      load: [databaseConfig, jwtConfig, fileStorageConfig],
    }),
  ],
})
export class AppModule {}
```


## Configuration Namespaces {#configuration-namespaces}


| Namespace     | File                  | Description       |
| ------------- | --------------------- | ----------------- |
| `database`    | `database.config.ts`  | DB connection     |
| `jwt`         | `jwt.config.ts`       | JWT settings      |
| `fileStorage` | `file-storage.config` | Storage provider  |
| `email`       | `email.config.ts`     | SMTP settings     |
| `social`      | `social.config.ts`    | OAuth credentials |


## Accessing Configuration {#accessing-configuration}


```typescript
@Injectable()
export class MyService {
  constructor(private configService: ConfigService) {}

  getDbHost(): string {
    return this.configService.get<string>("database.host", "localhost");
  }
}
```


## Environment Files {#environment-files}


| File              | Purpose             |
| ----------------- | ------------------- |
| `.env`            | Local development   |
| `.env.local`      | Local overrides     |
| `.env.staging`    | Staging environment |
| `.env.production` | Production settings |


## Validation {#validation}


Configuration is validated at startup using `class-validator`:

```typescript
export class EnvironmentVariables {
  @IsString()
  DB_HOST: string;

  @IsNumber()
  @Min(1)
  @Max(65535)
  DB_PORT: number;
}
```


## Related Pages {#related-pages}


- [Environment Variables](https://sourcey-gauzy.pages.dev/devops/environment-variables/index.md) — complete variable list
- [Production Deployment](https://sourcey-gauzy.pages.dev/devops/production-deployment/index.md) — deployment config