# Configuration

## Configuration Ingestion (Dynamic Identity)

AirBL acts on AirVPN servers by deriving your cryptographic identity and automatically generating the optimal routes internally.

Simply drop **just one** `.conf` file exported from your AirVPN client panel into the `conf/` volume directory.
*Example*: `AirVPN_Europe_UDP-1637.conf`

> **Note:** AirBL parses this single file to securely extract your subset `Address` IP mapping, your `PrivateKey`, and the network `PublicKey`. It then dynamically maps and generates hundreds of `wg0.conf` variants directly into the isolated `/app/confgen` directory on the fly—saving you from managing countless files!

## The Web UI Settings (`/settings`)

The dashboard features a robust, multi-category configuration panel ensuring all settings persist internally to `/app/data/airbl-settings.json`.

### General, Routing & Scan Triggers
- **Auto-Scan & Interval**: Automate background sweeps.
- **Speedtest Toggle**: Ensure clean servers are benchmarked after DroneBL scans.
- **MTU Clamping Override**: Forces custom MTU values into the WireGuard generation sequence. Presets include `1320` (AirVPN Default), `1420` (WireGuard standard), or arbitrary text fields.

### Port & Entry Discovery (The "Best Route")

AirBL now features a fully automated Multi-Day Discovery Engine:
- **Discovery Duration**: When enabled, AirBL cycles sequential networking combinations (Ports 1637, 47107, 51820) mapped against multiple Entry IPs directly utilizing the dynamic generator wrapper.
- **Data Gathering**: It averages the download, upload, and latency attributes for a specified timeframe (3 to 7 days) to eliminate anomalous network events. When the phase ends, it auto-locks to the proven fastest networking sequence.
- **Interactive Previews**: The active UI array card is clickable natively via a modal structure to audit raw port ping history vectors per endpoint.
- **AUTO Entry Resolution**: Select **AUTO** to analyze the local SQLite database for historical latency maps and lock strictly to the endpoint with the lowest ms ping rating.

### Performance & Ban Metrics
- **Throughput Drop Floor**: Set minimum Mbps requirements. Continual failures trigger automatic temporary bans (viewable in the "Disabled Servers" UI).
- **Abuse Filtering**: Repeated speedtest.net 403s flag the server in a cooled-down ban queue to stabilize charts.

### Geography Controls
- Filter entirely by Country or hyper-specific Cities using the checkbox grids. Unchecked locations are ignored entirely by the scanner logic.