> For the complete documentation index, see [llms.txt](https://voltx-1.gitbook.io/voltx-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voltx-1.gitbook.io/voltx-docs/advanced-settings/configuration-guide.md).

# Configuration Guide

This guide covers advanced configuration options after the initial setup.

1\. **Config.json**\
Already covered in the **Getting Started** page (login credentials).

#### 2. <mark style="color:orange;background-color:orange;">volt-headless.settings.json</mark>

* This file controls how VoltX performs, resource usage, and behavior.
* **Location:** Inside the VoltX folder.
* **Recommended Starting Configuration:**

> Copy and paste the settings below as a good starting point (you can adjust later based on your PC):

{% code expandable="true" %}

```json
{
  "auto_update": true,
  "cpu_cores": 0,
  "efficiency_mode": false,
  "fps": 5,
  "fps_cap": true,
  "hide_password": true,
  "hide_prints": true,
  "hide_warns": true,
  "no_render": true,
  "optimize_system": true,
  "ram_cap_mb": 1200,
  "ram_min_mb": 1000,
  "task_fps": 5,
  "virtual_ram_drive": "",
  "virtual_ram_gb": 200,
  "volt": {
    "anti_afk": false,
    "bit_library": false,
    "multi_instance": false,
    "raknet_library": false,
    "redirect_output": false,
    "silent_errors": false,
    "stream_proof_graphics": false,
    "unlock_window_size": false
  },
  "_help": "See explanations below..."
}
```

{% endcode %}

<details>

<summary><strong>Key Settings Explained</strong></summary>

<mark style="color:orange;background-color:orange;">no\_render</mark> — <mark style="color:orange;background-color:orange;">true</mark> = Black screen (saves a lot of GPU usage) → Recommended\ <mark style="color:orange;background-color:orange;">ram\_cap\_mb</mark> — Maximum RAM per Roblox instance → Recommended: <mark style="color:$success;">1200</mark>\ <mark style="color:orange;background-color:orange;">ram\_min\_mb</mark> — Minimum RAM reserved per instance → Recommended: <mark style="color:$success;">1000</mark>\ <mark style="color:orange;background-color:orange;">task\_fps</mark> & <mark style="color:orange;background-color:orange;">fps</mark> — Lower values = less CPU usage → Recommended: <mark style="color:$success;">5</mark>\ <mark style="color:orange;background-color:orange;">cpu\_cores</mark> — <mark style="color:orange;background-color:orange;">0</mark> = Use all available cores → Recommended: <mark style="color:$success;">0</mark>\ <mark style="color:orange;background-color:orange;">efficiency\_mode</mark> — Lower priority for Roblox → Recommended: <mark style="color:$success;">false</mark>\ <mark style="color:orange;background-color:orange;">optimize\_system</mark> — Applies useful system tweaks → Recommended: <mark style="color:$success;">true</mark>\
[<mark style="color:orange;background-color:orange;">virtual\_ram\_gb</mark>](/voltx-docs/advanced-settings/virtual-ram-guide.md) — Helps when running many instances\ <mark style="color:orange;background-color:orange;">auto\_update</mark> — Automatically updates VoltX → Recommended: <mark style="color:$success;">true</mark>

</details>

{% hint style="warning" %}
How to Apply Changes:

1. Edit <mark style="color:orange;background-color:orange;">volt-headless.settings.json</mark>
2. Save the file
3. Restart <mark style="color:orange;background-color:orange;">volt-headless.exe</mark>
   {% endhint %}
