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

# Configuration reference - VOICEVOX for Laravel

> Reference for all config/voicevox.php settings, including env variables, defaults, and examples.

This page covers all settings in `config/voicevox.php`.

## Publish the config file

```shell theme={null}
php artisan vendor:publish --tag="voicevox-config"
```

## `client` settings

### `client.url`

* Type: `string`
* Default: `'http://127.0.0.1:50021'`
* Env: `VOICEVOX_URL`

```php theme={null}
'client' => [
    'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
],
```

```dotenv theme={null}
VOICEVOX_URL=http://127.0.0.1:50021
```

### `client.core_version`

* Type: `string|null`
* Default: `null`
* Env: `VOICEVOX_CLIENT_CORE_VERSION`

```php theme={null}
'client' => [
    'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
],
```

```dotenv theme={null}
VOICEVOX_CLIENT_CORE_VERSION=0.15.0
```

## `core` settings

### `core.path`

* Type: `string|null`
* Default: `null`
* Env: `VOICEVOX_CORE_PATH`
* Required: Native mode and engine API mode

```php theme={null}
'core' => [
    'path' => env('VOICEVOX_CORE_PATH'),
],
```

```dotenv theme={null}
# macOS
VOICEVOX_CORE_PATH=/Users/username/.local/voicevox_core/

# Linux
VOICEVOX_CORE_PATH=/home/username/.local/voicevox_core/

# Windows
VOICEVOX_CORE_PATH=C:\Users\username\.local\voicevox_core\
```

### `core.dict`

* Type: `string`
* Default: `'dict/open_jtalk_dic_utf_8-1.11'`
* Env: `VOICEVOX_CORE_DICT_PATH`

```php theme={null}
'core' => [
    'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
],
```

### `core.models`

* Type: `string`
* Default: `'models/vvms'`
* Env: `VOICEVOX_CORE_MODELS_PATH`

```php theme={null}
'core' => [
    'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
],
```

### `core.user_dict`

* Type: `string`
* Default: `storage_path('voicevox/user_dict.json')`
* Env: `VOICEVOX_CORE_USER_DICT_PATH`

```php theme={null}
'core' => [
    'user_dict' => env('VOICEVOX_CORE_USER_DICT_PATH', storage_path('voicevox/user_dict.json')),
],
```

```dotenv theme={null}
VOICEVOX_CORE_USER_DICT_PATH=/path/to/custom/user_dict.json
```

Related page: [User dictionary](/en/packages/laravel-voicevox/native-user-dict)

### `core.presets`

* Type: `string`
* Default: `storage_path('voicevox/presets.json')`
* Env: `VOICEVOX_CORE_PRESETS_PATH`

```php theme={null}
'core' => [
    'presets' => env('VOICEVOX_CORE_PRESETS_PATH', storage_path('voicevox/presets.json')),
],
```

```dotenv theme={null}
VOICEVOX_CORE_PRESETS_PATH=/path/to/custom/presets.json
```

Related page: [Presets](/en/packages/laravel-voicevox/native-presets)

### `core.vvms`

* Type: `array`
* Default: `['0.vvm', '9.vvm', 's0.vvm']`
* Env: None

```php theme={null}
# Default (faster startup)
'core' => [
    'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
],

# Load all models (slower startup)
'core' => [
    'vvms' => [],
],
```

## `engine` settings

### `engine.disabled`

* Type: `bool`
* Default: `false`
* Env: `VOICEVOX_ENGINE_DISABLED`

```php theme={null}
'engine' => [
    'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
],
```

```dotenv theme={null}
VOICEVOX_ENGINE_DISABLED=true
```

### `engine.fallback_url`

* Type: `string`
* Default: `'http://127.0.0.1:50021'`
* Env: `VOICEVOX_ENGINE_FALLBACK_URL`

```php theme={null}
'engine' => [
    'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
],
```

```dotenv theme={null}
VOICEVOX_ENGINE_FALLBACK_URL=http://127.0.0.1:50021
```

### `engine.fallback_error`

* Type: `string`
* Default: `'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.'`
* Env: None

```php theme={null}
'engine' => [
    'fallback_error' => 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.',
],
```

<Tip>
  Start with `client.url` and `core.path`, then adjust `core.user_dict` and `core.presets` only when you need custom file locations.
</Tip>