# OneXray system requirements

Source: https://onexray.com/docs/system-requirements/
Description: Minimum operating systems and CPU architectures for OneXray, plus the runtime-library and kernel baseline for Ubuntu, Fedora and Arch Linux.
Language: en-US
Last updated: 2026-11-15


Check your operating system and CPU architecture before downloading OneXray. These requirements apply to the current official releases.

**Linux DEB, RPM, pacman and ZIP packages require a compatible distribution with glibc 2.39+, GLib 2.80+, the GTK 3 runtime and Linux kernel 5.3+ with pidfd support. Ubuntu 22.04 does not meet this baseline.**

## Supported systems

| Platform / edition | Minimum operating system | CPU architecture |
| --- | --- | --- |
| iPhone / iPad | iOS / iPadOS 16 | Supported iPhone and iPad devices |
| Mac App Store | macOS 13 | Apple silicon or Intel |
| Mac — OneXraySE | macOS 13 | Apple silicon or Intel |
| Android phones / tablets | Android 10 (API 29) | arm64-v8a or x86_64; 32-bit ARM is not supported |
| Windows x64 | Windows 10 20H2 (build 19042) | x64 |
| Windows ARM64 | Windows 11 | ARM64 |
| Linux DEB / RPM / pacman / ZIP | A compatible distribution; see the requirements below | x86_64 or arm64 (aarch64) |

For download links, package differences and required VPN permissions, see [installation](https://onexray.com/docs/install/) and [first connection](https://onexray.com/docs/getting-started/).

## Linux requirements

OneXray requires a graphical desktop session. Keep the entire extracted ZIP bundle together when using that package.

All four Linux package formats use the same host-library baseline:

| Component | Requirement |
| --- | --- |
| Distribution baseline | Ubuntu 24.04 LTS, or another distribution that provides all the libraries below |
| glibc | 2.39 or newer (official package baseline) |
| GLib | 2.80 or newer |
| GTK | GTK 3 runtime |
| Kernel | Linux 5.3 or newer with pidfd support, used to monitor the Core process |
| CPU | x86_64 or arm64 (aarch64), matching the downloaded package |

Choose [DEB for Debian/Ubuntu](https://onexray.com/docs/install/#linux-deb), [RPM for Fedora](https://onexray.com/docs/install/#linux-rpm), or [pacman for Arch Linux](https://onexray.com/docs/install/#linux-pacman), using a format supplied by the selected release. These native packages install declared dependencies and grant Core capabilities on installation and upgrades. [ZIP](https://onexray.com/docs/install/#linux-zip) requires manual dependency installation and capability setup. All formats share the baseline above; the standard Arch Linux instructions cover x86_64, while ARM64 requires a compatible distribution.

**Ubuntu 22.04 is not compatible with the current official Linux packages.** Its GLib 2.72 does not provide APIs required by the app's native libraries, such as [`g_once_init_enter_pointer`](https://docs.gtk.org/glib/type_func.Once.init_enter_pointer.html), introduced in GLib 2.80. This can cause a missing-symbol error before the window opens.

Installing GTK alone does not satisfy the separate GLib and glibc requirements. Updating OneXray alone does not upgrade those system libraries either. Use Ubuntu 24.04 LTS or a distribution that meets the complete baseline, then follow the [Linux installation and capability instructions](https://onexray.com/docs/install/#linux).

### Check your Linux system

These commands show the distribution, glibc version and kernel version:

```shell
cat /etc/os-release
ldd --version
uname -r
```

On Debian/Ubuntu, inspect the installed GLib and GTK runtime package versions:

```shell
dpkg-query -W 'libglib2.0-0*' 'libgtk-3-0*'
```

On Fedora:

```shell
rpm -q glibc glib2 gtk3
```

On Arch Linux:

```shell
pacman -Q glibc glib2 gtk3
```

A newer kernel does not replace missing or older user-space libraries. Check every requirement before installing.