# How to Configure Your Stay in Tarkov Server (/docs/stay-in-tarkov/configure-your-server)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Your Stay in Tarkov server runs on the SPT (Single Player Tarkov) framework — a Node.js application that handles player profiles, traders, loot, quests, and game progression. Configuration is managed through several JSON files in the server's file system, with `http.json` controlling network settings and various config files under `Aki_Data/` controlling gameplay.

Configuration Files Overview [#configuration-files-overview]

| File Path                                         | Purpose                                                        |
| ------------------------------------------------- | -------------------------------------------------------------- |
| `Aki_Data/Server/configs/http.json`               | Network settings — IP address, port, and backend URL           |
| `Aki_Data/Server/configs/core.json`               | Core server settings — version compatibility, server name      |
| `Aki_Data/Server/configs/gameplay.json`           | Gameplay tweaks — item limits, quest settings, seasonal events |
| `Aki_Data/Server/configs/location.json`           | Raid and map settings — loot multipliers, bot spawns per map   |
| `Aki_Data/Server/configs/trader.json`             | Trader settings — restock timers, purchase limits, flea market |
| `Aki_Data/Server/configs/bot.json`                | AI bot settings — difficulty, spawn rates, behavior            |
| `user/mods/fika-server/assets/configs/fika.jsonc` | Fika multiplayer settings — dedicated hosting, P2P options     |

Editing Configuration Files [#editing-configuration-files]

<div className="fd-steps">
  <div className="fd-step">
    Open the XGamingServer panel [#1-open-the-xgamingserver-panel]

    Log in to the [XGamingServer panel](https://panel.xgamingserver.com) and stop your Stay in Tarkov server.
  </div>

  <div className="fd-step">
    Navigate to Files [#2-navigate-to-files]

    In the sidebar, go to `Files`.
  </div>

  <div className="fd-step">
    Open the config file [#3-open-the-config-file]

    Navigate to the config file you want to edit (see paths in the table above).
  </div>

  <div className="fd-step">
    Edit your settings [#4-edit-your-settings]

    Modify the JSON values as needed. Be careful to maintain valid JSON syntax — misplaced commas or brackets will prevent the server from starting.
  </div>

  <div className="fd-step">
    Save and restart [#5-save-and-restart]

    Click **Save** and restart your server.

    > ⚠️ **Warning:** Always stop your server before editing configuration files. SPT loads configs at startup, so changes made while running won't take effect until the next restart, and the server may overwrite your changes when it shuts down.
  </div>
</div>

Network Configuration (http.json) [#network-configuration-httpjson]

The `http.json` file controls how your server listens for connections:

<div className="fd-steps">
  <div className="fd-step">
    Open http.json [#1-open-httpjson]

    Navigate to `Files` → `Aki_Data/Server/configs/http.json`.
  </div>

  <div className="fd-step">
    Review the settings [#2-review-the-settings]

    ```json
    {
        "ip": "0.0.0.0",
        "port": 6969,
        "backendIp": "0.0.0.0",
        "backendPort": 6969,
        "webSocketPingDelayMs": 90000
    }
    ```

    | Setting                | Description                                                           | Default   |
    | ---------------------- | --------------------------------------------------------------------- | --------- |
    | `ip`                   | The IP address the server listens on. `0.0.0.0` means all interfaces. | `0.0.0.0` |
    | `port`                 | The port the server listens on                                        | `6969`    |
    | `backendIp`            | The IP address for the backend API                                    | `0.0.0.0` |
    | `backendPort`          | The port for the backend API                                          | `6969`    |
    | `webSocketPingDelayMs` | WebSocket keepalive interval in milliseconds                          | `90000`   |

    > 📝 **Note:** On XGamingServer, the `ip` and `port` settings are typically managed automatically. You usually don't need to change `http.json` unless instructed by support. The port shown on your panel matches the one configured here.
  </div>
</div>

Gameplay Configuration [#gameplay-configuration]

Loot and Economy [#loot-and-economy]

Edit `Aki_Data/Server/configs/gameplay.json` to adjust the in-raid experience:

```json
{
    "lootItemResourceRandomization": true,
    "globalLootChanceModifier": 1.0,
    "inRaid": {
        "MIAOnRaidEnd": false,
        "saveLootOnSurvive": true,
        "carExtractBaseStandingGain": 0.25
    }
}
```

| Setting                         | Description                                                         | Default |
| ------------------------------- | ------------------------------------------------------------------- | ------- |
| `globalLootChanceModifier`      | Multiplier for loot spawn chance (1.0 = default, 2.0 = double loot) | `1.0`   |
| `lootItemResourceRandomization` | Whether loot items have randomized resource amounts                 | `true`  |
| `MIAOnRaidEnd`                  | Whether players go MIA if the raid timer expires                    | `false` |
| `saveLootOnSurvive`             | Whether players keep their loot after surviving a raid              | `true`  |

> 💡 **Tip:** Increasing `globalLootChanceModifier` to `1.5` or `2.0` creates a more casual, loot-rich experience. This is popular for servers where players want faster progression. Setting it below `1.0` creates a more hardcore, scarce-loot experience.

Bot Configuration [#bot-configuration]

Edit `Aki_Data/Server/configs/bot.json` to control AI behavior:

| Setting            | Description                                            | Default       |
| ------------------ | ------------------------------------------------------ | ------------- |
| `difficulty`       | AI difficulty (`easy`, `normal`, `hard`, `impossible`) | `normal`      |
| `maxBotCap`        | Maximum number of bots active at once                  | Varies by map |
| `pmcBotEnabled`    | Whether AI PMCs spawn in raids                         | `true`        |
| `scavWaveQuantity` | Number of scavs per spawn wave                         | Varies        |

Trader Configuration [#trader-configuration]

Edit `Aki_Data/Server/configs/trader.json` to customize the economy:

| Setting                 | Description                                    | Default |
| ----------------------- | ---------------------------------------------- | ------- |
| `updateTime`            | How often traders restock (in seconds)         | `3600`  |
| `purchaseLimitsEnabled` | Whether traders have buy limits                | `true`  |
| `fleaMarketEnabled`     | Enable or disable the flea market              | `true`  |
| `fleaMarketMinLevel`    | Minimum player level to access the flea market | `15`    |

Fika Multiplayer Settings [#fika-multiplayer-settings]

The Fika configuration controls multiplayer-specific behavior:

<div className="fd-steps">
  <div className="fd-step">
    Open Fika config [#1-open-fika-config]

    Navigate to `Files` → `user/mods/fika-server/assets/configs/fika.jsonc`.
  </div>

  <div className="fd-step">
    Configure Fika settings [#2-configure-fika-settings]

    Key Fika settings include:

    | Setting                          | Description                                                       | Default |
    | -------------------------------- | ----------------------------------------------------------------- | ------- |
    | `server.giftedItemsLoseFIR`      | Whether items sent between players lose Found in Raid status      | `true`  |
    | `server.launcherListAllProfiles` | Show all profiles in the launcher (not just the logged-in user's) | `false` |
    | `server.sessionTimeout`          | How long before an inactive session expires (seconds)             | `300`   |
    | `client.useBTR`                  | Whether the BTR (armored vehicle) spawns in Streets               | `true`  |
    | `client.friendlyFire`            | Whether players on the same team can damage each other            | `true`  |
    | `client.dynamicVExfils`          | Enable dynamic vehicle extracts                                   | `false` |

    > 📝 **Note:** Fika config files use the `.jsonc` extension, which supports comments (lines starting with `//`). The comments in the file explain each setting — read them carefully before changing values.
  </div>
</div>

Core Server Settings [#core-server-settings]

Edit `Aki_Data/Server/configs/core.json` for fundamental server settings:

```json
{
    "akiVersion": "3.9.x",
    "projectName": "SPT",
    "compatibleTarkovVersion": "0.14.x.x",
    "serverName": "SPT Server",
    "profileSaveIntervalSeconds": 15
}
```

| Setting                      | Description                                                             |
| ---------------------------- | ----------------------------------------------------------------------- |
| `serverName`                 | The name of your server (displayed in the launcher)                     |
| `profileSaveIntervalSeconds` | How frequently player profiles are auto-saved                           |
| `compatibleTarkovVersion`    | The Tarkov version this server supports (informational — do not change) |

Backing Up Your Configuration [#backing-up-your-configuration]

Before making significant changes, back up your config files:

<div className="fd-steps">
  <div className="fd-step">
    Open Files [#1-open-files]

    Go to `Files` in the sidebar.
  </div>

  <div className="fd-step">
    Download your configs [#2-download-your-configs]

    Navigate to `Aki_Data/Server/configs/` and click the **three dots** menu next to each file you want to back up, then select **Download**.
  </div>

  <div className="fd-step">
    Back up profiles too [#3-back-up-profiles-too]

    Also back up `user/profiles/` — this contains all player save data. Losing profiles means players lose all their progress.

    > 💡 **Tip:** Use the **Backups** section in the sidebar to set up scheduled automatic backups. This protects both your configuration and player profiles against accidental changes or corruption.
  </div>
</div>

Validating JSON [#validating-json]

SPT configuration files are strict JSON. A single missing comma, extra bracket, or trailing comma will prevent the server from starting. If your server won't start after editing a config file:

1. Check `Console` on the XGamingServer panel for error messages — they usually point to the exact file and line number causing the issue.
2. Paste your edited file into a JSON validator like [JSONLint](https://jsonlint.com/) to find syntax errors.
3. If all else fails, delete the problematic config file and restart — SPT will regenerate it with default values.

If you get stuck at any time, you can join our [Discord](https://discord.xgamingserver.com/).