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

# Settings

> Configure application settings — server, appearance, behavior.

# Settings

The Settings panel lets you configure every aspect of Cluster Terminal -- from the server connection and visual theme to chart defaults, data loading behavior, and sound preferences.

Open Settings from the gear icon in the header bar, or press `Ctrl + ,`.

## Server Connection

Cluster Terminal connects to a data server for all market data (candles, clusters, open interest) and real-time WebSocket streaming.

### Quick Server Switch

The fastest way to switch servers is the **server indicator** in the header bar. Click the connection status label to open the server selector dropdown:

| Server     | Location          | URL                             |
| ---------- | ----------------- | ------------------------------- |
| **FIN1**   | Finland (Hetzner) | `https://fin1-strm.incrypto.ru` |
| **RU1**    | Russia            | `https://ru1-strm.incrypto.ru`  |
| **Custom** | User-defined      | Any URL                         |

Selecting a server instantly reconnects both REST and WebSocket connections. All open charts reload data from the new server. The selected server persists across app restarts.

<Tip>
  Choose the server closest to your location for lowest latency. Both FIN1 and RU1 maintain identical data — switching servers does not affect your history or analysis.
</Tip>

### Manual Server URL

For advanced setups (self-hosted servers, custom ports), use the Settings panel:

<Steps>
  <Step title="Open Settings">
    Click the gear icon or press `Ctrl + ,`.
  </Step>

  <Step title="Select Custom Server">
    In the **Server** section, select "Custom" and enter the full URL (e.g., `https://my-server.example.com`).
  </Step>

  <Step title="Test Connection">
    The application automatically tests the connection when you save. A green checkmark indicates success; a red icon indicates the server is unreachable.
  </Step>
</Steps>

<Warning>
  Changing the server disconnects all active WebSocket streams and reloads chart data from the new server.
</Warning>

## Appearance

### Language

Cluster Terminal supports multiple interface languages.

| Language    | Status       |
| ----------- | ------------ |
| **English** | Full support |
| **Russian** | Full support |

Switch language in **Settings > Appearance > Language**. The change takes effect immediately without restarting.

### Theme

| Theme     | Description                                                      |
| --------- | ---------------------------------------------------------------- |
| **Dark**  | Dark background, light text. Optimized for extended screen time. |
| **Light** | Light background, dark text.                                     |

<Tip>
  Dark theme is recommended for trading to reduce eye strain during long sessions, especially with multiple monitors.
</Tip>

## Chart Defaults

These settings control the initial configuration when you create a new chart tab.

| Setting                | Description                     | Options                              |
| ---------------------- | ------------------------------- | ------------------------------------ |
| **Default chart type** | Chart type for new tabs         | Candlestick, Cluster, TPO, Heatmap   |
| **Default timeframe**  | Initial timeframe               | 1m, 5m, 15m, 1h, 4h, 1D, 1W, 1M      |
| **Default symbol**     | Initial symbol                  | Any available symbol (e.g., BTCUSDT) |
| **Candle colors**      | Bullish / bearish candle colors | Color picker                         |

<Note>
  These defaults only apply to newly created tabs. Existing tabs retain their own settings.
</Note>

## Data Loading

Control how historical data is fetched and cached.

| Setting                 | Description                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| **Progressive loading** | Load volume/cluster data in chunks with a progress bar. Keeps the UI responsive for large date ranges. |
| **History depth**       | How far back to load data on chart open. Deeper history means longer initial load times.               |

### Progressive Loading

When enabled, large data requests (especially cluster volumes) are split into daily chunks and loaded sequentially. A progress bar in the chart toolbar shows loading status.

<Tip>
  Keep progressive loading enabled. It prevents the UI from freezing when loading months of cluster data, especially for high-volume symbols like BTCUSDT.
</Tip>

## Cache

Manage local data caching to speed up chart loading.

| Setting              | Description                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------- |
| **Persistent cache** | Store fetched data locally in IndexedDB so charts load instantly on next open                |
| **Cache size**       | Displays the current number of entries and estimated size in MB                              |
| **Clear cache**      | Removes all cached data (clusters, volumes, heatmap, OI, archives) from memory and IndexedDB |

When persistent cache is enabled, historical data that has already been fetched is stored locally. The next time you open a chart for the same symbol and timeframe, data loads from the cache instead of fetching from the server.

<Tip>
  If charts show stale or incorrect data, clear the cache and reload. This forces a fresh fetch from the server.
</Tip>

## Telegram Notifications

Send alert notifications directly to a Telegram chat or channel via a bot.

| Setting             | Description                                          |
| ------------------- | ---------------------------------------------------- |
| **Enable Telegram** | Toggle Telegram notification delivery                |
| **Bot token**       | Token from [@BotFather](https://t.me/BotFather)      |
| **Chat ID**         | Telegram chat or channel ID (e.g., `-1001234567890`) |
| **Test connection** | Send a test message to verify the setup              |

### Notification Filters

Choose which events are forwarded to Telegram:

| Filter               | Description                                   |
| -------------------- | --------------------------------------------- |
| **Price alerts**     | Alerts triggered by drawing tool price levels |
| **Indicator alerts** | Notifications from indicator alert rules      |
| **Calendar alerts**  | Economic calendar event reminders             |

<Note>
  The bot must be added to the target chat/channel and have permission to send messages. Use [@userinfobot](https://t.me/userinfobot) to find your chat ID.
</Note>

## Economic Calendar

Display upcoming macroeconomic events on the chart and receive pre-event notifications.

| Setting                  | Description                                                        |
| ------------------------ | ------------------------------------------------------------------ |
| **Enable calendar**      | Toggle the economic calendar feature                               |
| **Show on chart**        | Display event markers on the time axis                             |
| **Minimum impact**       | Filter events by importance: High, Medium, or Low                  |
| **Countries**            | Filter by country or currency (e.g., USD, EUR)                     |
| **Alert minutes before** | How many minutes before an event to trigger a notification (0--60) |
| **JBlanked API key**     | Optional API key for accessing past and future week data           |

The current week's events are fetched from ForexFactory (free, no key required). To browse past or upcoming weeks, enter a JBlanked API key.

<Tip>
  Set "Minimum impact" to High if you only want to see major events like FOMC, NFP, and CPI releases.
</Tip>

## Sound Settings

Configure audio notifications for alerts and system events.

| Setting          | Description                                                 |
| ---------------- | ----------------------------------------------------------- |
| **Alert sounds** | Enable or disable sound when price/indicator alerts trigger |
| **Sound volume** | Master volume for all notification sounds                   |

Alert sounds are synthesized in-browser -- no external audio files are needed. Each alert type has a distinct sound pattern to help you distinguish between price alerts, indicator signals, and system notifications without looking at the screen.

## License

View and manage your license status.

| Field           | Description                                             |
| --------------- | ------------------------------------------------------- |
| **License key** | Your active license key (CT-XXXX-XXXX-XXXX-XXXX format) |
| **Status**      | Active, Trial, or Expired                               |
| **Features**    | Enabled features (e.g., cloud\_sync, priority\_support) |
| **Devices**     | Number of activated devices out of maximum allowed      |
| **Expiry**      | License expiration date                                 |

### Trial Mode

If you have not entered a license key, Cluster Terminal runs in trial mode for 7 days with full functionality. After the trial expires, you need a license key to continue using the application.

<Note>
  Trial duration may vary. The server administrator can configure the trial period via the admin panel.
</Note>

### Activating a License

<Steps>
  <Step title="Obtain a license key">
    Purchase a license or receive one from the project administrator. Keys are in the format `CT-XXXX-XXXX-XXXX-XXXX`.
  </Step>

  <Step title="Enter the key">
    Go to **Settings > License** and paste your key into the license field.
  </Step>

  <Step title="Activate">
    Click **Activate**. The application validates the key with the server and registers your device.
  </Step>
</Steps>

<Warning>
  Each license has a maximum device limit. If you reach the limit, deactivate an existing device from the server admin panel or contact support.
</Warning>

## Resetting Settings

To reset all settings to defaults, clear the application data directory. On Windows, this is located at:

```
%APPDATA%/com.cluster-terminal/
```

<Warning>
  Resetting application data removes all local workspaces, license activation, trial state, and cached data. This cannot be undone.
</Warning>