# VRS X Configuration

# Feed configuration

## Feed Configuration

To start tracking aircraft, you need to connect VRS X to a data source (Feeder).

### Step-by-Step Setup

1. Open the **Admin Panel**.
2. Click on the **Feeds** tab in the sidebar.
3. Click the **+ Add Feed** button.

[![Feed-01.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zrzut-ekranu-2026-02-26-o-18-42-38.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zrzut-ekranu-2026-02-26-o-18-42-38.png)

### Configuration Fields

<div class="horizontal-scroll-wrapper" id="bkmrk-field-description-na"><div class="table-block-component"><div _ngcontent-ng-c2310012560="" class="table-block has-export-button is-at-scroll-start"><div _ngcontent-ng-c2310012560="" class="table-content not-end-of-paragraph" data-hveid="0" data-ved="0CAAQ3ecQahgKEwih4MCbyveSAxUAAAAAHQAAAAAQuQQ" decode-data-ved="1" jslog="275421;track:impression,attention" not-end-of-paragraph=""><table data-path-to-node="8"><thead><tr><td><span data-path-to-node="8,0,0,0">Field</span></td><td><span data-path-to-node="8,0,1,0">Description</span></td></tr></thead><tbody><tr><td><span data-path-to-node="8,1,0,0">**Name**</span></td><td><span data-path-to-node="8,1,1,0">A unique name for your feed (e.g., "Home Pi5" or "Radarcape").</span></td></tr><tr><td><span data-path-to-node="8,2,0,0">**Address**</span></td><td><span data-path-to-node="8,2,1,0">IP address or Serial Port of your feeder.</span></td></tr><tr><td><span data-path-to-node="8,3,0,0">**Port**</span></td><td><span data-path-to-node="8,3,1,0">The network port (e.g., `30005` for Beast).</span></td></tr><tr><td><span data-path-to-node="8,4,0,0">**Format**</span></td><td><span data-path-to-node="8,4,1,0">Select **Beast** or **BaseStation** from the dropdown.</span></td></tr><tr><td><span data-path-to-node="8,5,0,0">**Connection Type**</span></td><td><span data-path-to-node="8,5,1,0">Usually set to **TCP Adapter**.</span></td></tr><tr><td><span data-path-to-node="8,6,0,0">**Receiver Location**</span></td><td><span data-path-to-node="8,6,1,0">Select your coordinates (defined in the "Receiver Locations" section).</span></td></tr></tbody></table>

</div><div _ngcontent-ng-c2310012560="" class="table-footer hide-from-message-actions" hide-from-message-actions="">  
</div></div></div></div>### Connection Modes

- **Active (Standard):** VRS X will initiate the connection to your feeder.
- **Passive (Push):** VRS X will open a port and wait for the feeder to push data to it

[![Feed-02.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zrzut-ekranu-2026-02-26-o-19-14-02.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zrzut-ekranu-2026-02-26-o-19-14-02.png)

---

> 💡 **PRO TIP:** Once saved, your feed will appear in the list. Check the **STATUS** column to verify the connection.

> ⚠️ **IMPORTANT NOTE:** If you are using **Active Mode** and the connection fails, the **STATUS** column will provide a detailed error log. Please note that in **Passive Mode**, status information is limited since VRS X is just waiting for incoming traffic!

# Additional data: Aircraft Database

## Data Sources: Aircraft Database

VRS X does not come with a built-in aircraft database. Why? Because I believe **your** database is the best, and I know how much time you've spent perfecting it.

By using the **BYOD (Bring Your Own Data)** approach, VRS X acts as a high-performance compatibility layer. You bring the data, and VRS X makes it fly. This also ensures we stay 100% compliant with various data provider licenses.

### Supported Formats

<div class="horizontal-scroll-wrapper" id="bkmrk-format-description-b"><div class="table-block-component"><div _ngcontent-ng-c2310012560="" class="table-block has-export-button is-at-scroll-start"><div _ngcontent-ng-c2310012560="" class="table-content not-end-of-paragraph" data-hveid="0" data-ved="0CAAQ3ecQahgKEwih4MCbyveSAxUAAAAAHQAAAAAQ_wQ" decode-data-ved="1" jslog="275421;track:impression,attention" not-end-of-paragraph=""><table data-path-to-node="7"><thead><tr><td><span data-path-to-node="7,0,0,0">Format</span></td><td><span data-path-to-node="7,0,1,0">Description</span></td></tr></thead><tbody><tr><td><span data-path-to-node="7,1,0,0">**BaseStation.sqb**</span></td><td><span data-path-to-node="7,1,1,0">The classic "Old-but-Gold" SQLite database.</span></td></tr><tr><td><span data-path-to-node="7,2,0,0">**OpenSky Network**</span></td><td><span data-path-to-node="7,2,1,0">CSV files provided by the OpenSky community.</span></td></tr><tr><td><span data-path-to-node="7,3,0,0">**ADS-B Exchange**</span></td><td><span data-path-to-node="7,3,1,0">NDJSON files (full support for `.json.gz` to save bandwidth).</span></td></tr></tbody></table>

</div><div _ngcontent-ng-c2310012560="" class="table-footer hide-from-message-actions" hide-from-message-actions=""></div></div></div></div>---

### How to Import Data

Importing hundreds of thousands of records is optimized to take only a few seconds, depending on your CPU power.

1. Go to the **Admin Panel**.
2. Select **Server Settings** from the menu.
3. Scroll down to the **BaseStation Database** section.
4. **Paste the download URL** for your chosen data source.
5. Click the corresponding **"Import from..."** button.
6. Scroll to the bottom and click **Save Configuration**.
7. **Restart VRS X** to apply changes.

[![aircraft-dataset-import.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zrzut-ekranu-2026-02-26-o-22-58-01.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zrzut-ekranu-2026-02-26-o-22-58-01.png)

---

> 🛠️ **Developer's Note (Visual Bug):** &gt; Currently, you might see **OpenAIP** settings in this section. This is a known visual bug and will be moved to its proper place in the next update.

> 🚀 **Future Roadmap:** &gt; In upcoming versions, this entire section will move to a dedicated **Resources** tab, featuring a built-in **Database Editor** for direct manipulation of your records.

# Additional data: Airport Database.

## Data Sources: Airport Database (OurAirports)

To display airports, runways, and metadata on the map, VRS X utilizes the community-driven **OurAirports** dataset. This allows you to have up-to-date global airport information without bloating the core application.

### The Workflow

Just like the Aircraft Database, this follows the **BYOD** principle. You provide the source, and VRS X handles the heavy lifting of parsing and rendering.

1. Navigate to **Admin Panel** -&gt; **Server Settings**.
2. Locate the **Airport Database (OurAirports CSV)** section.
3. **CSV URL:** Paste the link to an OurAirports-compatible CSV file.
    
    
    - *Default recommendation:* `https://davidmegginson.github.io/ourairports-data/airports.csv`
4. Click **Import Airports**. The process is highly optimized and will finish in a few seconds
5. Scroll down and click **Save Configuration**
6. Restart VRS X.

[![airport-import.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zrzut-ekranu-2026-02-26-o-23-04-25.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zrzut-ekranu-2026-02-26-o-23-04-25.png)

---

### Visible Airport Categories

Not every "airport" is a massive international hub. To keep your map clean and high-performance, you can toggle which categories are natively rendered on the map engine.

**Available categories include:**

- Large, Medium, and Small airports
- Heliports and Seaplane bases
- Balloonports
- Closed facilities

> 💡 **Pro-Tip:** If your map feels cluttered, try unchecking "small airport" or "closed" to focus only on major hubs.

---

### ⚠️ License &amp; Responsibility

> **Bring Your Own Data:** The administrator is responsible for complying with the license and terms of the dataset provided. Ensure you respect the attribution requirements of OurAirports or any other source you decide to use.

# Aircraft marker mapping

## Aircraft Icon Mapping

While VRS X features an intelligent automatic icon selection based on Weight Turbulence Category (WTC), you can manually override these defaults for specific aircraft. This allows you to assign dedicated silhouettes to your favorite or most common aircraft types.

### How it Works

Manual mappings are the highest priority in the rendering engine. If an ICAO code is defined here, its assigned icon will **always** take priority over WTC-based automatic selection.

### Adding a New Mapping

1. Navigate to the **Icon Mapping** section in the sidebar.
2. Under **Add New Mapping**, enter the **ICAO TYPE CODE** (e.g., `B748`, `A35k`, or `GLID`).
3. Select the desired **ICON** from the dropdown menu.
4. Click **+ Add Mapping**.
5. Click **Save Mapping** and refresh VRS X radar page.

[![Zrzut ekranu 2026-02-26 o 23.07.06.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zrzut-ekranu-2026-02-26-o-23-07-06.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zrzut-ekranu-2026-02-26-o-23-07-06.png)

### Managing Your Icons

The mapping table provides a clear overview of your custom silhouettes:

- **Filter:** Quickly search through your mappings using the filter box (useful when you have dozens of custom icons).
- **Preview:** See the actual marker silhouette in the **Preview** column before it hits the live map.
- **Actions:** Easily remove a mapping by clicking **× Delete** if you want to revert to automatic WTC selection for that type.

# VRS X Security: Radar Privacy & User management

## User Management &amp; Access Control

This section handles the security of your VRS X instance, allowing you to control who can view your radar data and who can modify server configurations.

### Radar Visibility

The **Web Server settings** defines the global reach of your radar map. You can find it under **Server Settings** option:

[![image.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/zglX7e6zE54foMfG-image.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/zglX7e6zE54foMfG-image.png)

- **Web server port:** Port number on which radar will be accessible
- **Admin port**: WiP: Port number for Admin Panel - Admin port can be the same as Web Server Port, but mind the security
- **RADAR VISIBILTY:** defines if radar is private or public. If Radar Visibility is OFF, user login is required. If its ON, everyone can see the radar.

---

### User Management (IAM)

VRS X includes a basic Identity and Access Management (IAM) system. This allows an administrator to create dedicated accounts for other users or additional admins.

You can find this panel under **Users** in the sidebar.

#### Roles and Privileges

<div class="horizontal-scroll-wrapper" id="bkmrk-role-permissions-adm"><div class="table-block-component"><div _ngcontent-ng-c2310012560="" class="table-block has-export-button is-at-scroll-start"><div _ngcontent-ng-c2310012560="" class="table-content not-end-of-paragraph" data-hveid="0" data-ved="0CAAQ3ecQahgKEwih4MCbyveSAxUAAAAAHQAAAAAQowY" decode-data-ved="1" jslog="275421;track:impression,attention" not-end-of-paragraph=""><table data-path-to-node="12"><thead><tr><td><span data-path-to-node="12,0,0,0">Role</span></td><td><span data-path-to-node="12,0,1,0">Permissions</span></td></tr></thead><tbody><tr><td><span data-path-to-node="12,1,0,0">**Admin**</span></td><td><span data-path-to-node="12,1,1,0">Complete access to the Admin Panel, server settings, and user management.</span></td></tr><tr><td><span data-path-to-node="12,2,0,0">**User**</span></td><td><span data-path-to-node="12,2,1,0">Authorized to view the radar map (when set to Private) but has no access to administrative tools.</span></td></tr></tbody></table>

</div><div _ngcontent-ng-c2310012560="" class="table-footer hide-from-message-actions" hide-from-message-actions="">  
</div></div></div></div>#### Administrator Actions

Administrators have the power to manage the user lifecycle at any time:

- **Toggle Role:** Instantly change a user's privileges between "User" and "Admin".
- **Reset PW:** Reset a user's password if they lose access.
- **Delete:** Permanently revoke access by deleting the account.

#### Creating New Users

Only an existing **Admin** can create new accounts.

1. Enter a **Username** (minimum 3 characters).
2. Assign a **Temporary Password** (minimum 6 characters).
3. Select the **Role** and click **Create User**.

> 💡 **First Login Policy:** To ensure account security, any new user **must change their password** upon their first login. If a user has not yet completed this step, their status will be displayed as **"Must change password"** in the management table.

# External API Integrations

## External API Integrations: Google Maps &amp; OpenAIP

<span style="white-space: pre-wrap;">To enhance your radar experience with professional-grade base layers and aeronautical data, VRS X supports integration with third-party providers. These configurations are located in the </span>**General Settings**<span style="white-space: pre-wrap;"> panel.</span>

---

### 1. Google Maps Integration

<span style="white-space: pre-wrap;">Adding a Google Maps API key unlocks premium base layers, including </span>**Streets**<span style="white-space: pre-wrap;">, </span>**Satellite**<span style="white-space: pre-wrap;">, and </span>**Hybrid**<span style="white-space: pre-wrap;"> views.</span>

- **Setup**<span style="white-space: pre-wrap;">: Enter your unique key into the </span>**Google Maps API Key**<span style="white-space: pre-wrap;"> field.</span>
- **Verification**<span style="white-space: pre-wrap;">: Click the </span>**Test Key**<span style="white-space: pre-wrap;"> button to instantly verify if your API key is valid and active.</span>
- **Result**: Upon a successful test and save, the radar map will display additional Google Maps base layer options.

### 2. OpenAIP Integration

OpenAIP provides critical aeronautical layers, such as global airspaces and specialized airport data.

- **Setup**<span style="white-space: pre-wrap;">: Enter your Client ID (obtained from </span>**openaip.net**<span style="white-space: pre-wrap;">) into the </span>**OpenAIP API Key (Client ID)**<span style="white-space: pre-wrap;"> field.</span>
- **Validation**: Note that unlike Google Maps, there is no manual "Test" button for OpenAIP; the key is validated when the map engine requests data layers.
- **Result**: Once configured, OpenAIP layers like Airspace and specialized Airports will be available for rendering.

[![image.png](https://docs.vrsx.app/uploads/images/gallery/2026-02/scaled-1680-/APZMN78S1c0bjEcB-image.png)](https://docs.vrsx.app/uploads/images/gallery/2026-02/APZMN78S1c0bjEcB-image.png)

---

### 💾 Saving Your Configuration

To apply any changes made to External API Integrations:

1. Ensure your keys are correctly pasted.
2. <span style="white-space: pre-wrap;">Scroll to the bottom of the </span>**General Settings**<span style="white-space: pre-wrap;"> page.</span>
3. <span style="white-space: pre-wrap;">Click the </span>**Save Settings**<span style="white-space: pre-wrap;"> button to persist your changes to the server.</span>