# Add servers

Source: https://onexray.com/docs/servers/import/
Description: Import links, subscriptions, node JSON, files, and QR codes into OneXray without a second node confirmation.


After entering the main interface, open Servers > Add servers. Import is not part of the first-run setup.

| Action | Behavior |
| --- | --- |
| Paste link | Open the pasted text for submission |
| Add subscription | Enter a name, HTTPS URL, and optional age/HWID settings |
| Import file | Open the system file picker directly |
| Manual add | Open a JSON editor, not protocol-specific form fields |
| Scan QR code | Open the scanner on iOS/Android only |

Supported input includes compatible protocol share links and Xray JSON nodes. Text files and QR images can use the file-import path.

## Import scope

A normal server import extracts outbounds only. It does not apply the source document's routing, DNS, or other complete-configuration settings. Use [Custom Routing](https://onexray.com/docs/connect/custom-routing/) or [Raw JSON](https://onexray.com/docs/connect/raw-json/) for those workflows.

For batch subscriptions, use one HTTPS URL per line:

```text
https://example.com/sub-one#Personal
https://example.com/sub-two#Work
```

The fragment supplies the initial display name and is not part of the saved request URL. These are format examples, not working subscriptions.

## Completion and errors

Ordinary nodes are parsed and saved after submission, file selection, or scanning. There is no extra node-preview confirmation. The app reports the number imported; if no valid nodes are found, it saves nothing and reports an error.

New nodes enter the shared test queue after import. Tests do not block finishing import or opening Connect. Complete Raw/Custom configurations and routing-data dependencies keep their own preview/confirmation step.

Node validity follows libXray. Imported protocol support does not imply that every setting from another client's full configuration is supported.

To generate a JSON file with AI, read the [outbound contract](https://onexray.com/docs/configuration/outbound/). For a full route or Raw configuration, use its [separate import entry](https://onexray.com/docs/configuration/).

See the protocol guides for [VLESS/REALITY](https://onexray.com/docs/protocols/vless/), [XHTTP](https://onexray.com/docs/protocols/xhttp/) and [VMessAEAD](https://onexray.com/docs/protocols/vmess/). They explain what to request from your provider before generating JSON.