Support

Maintenance Policy

Platform support tiers, lifecycle policy, and open-source licensing for OneBox and OneBoxM

Summary: OneBox (desktop) and OneBoxM (mobile) follow official OS vendor support windows. Primary support goes to macOS and iOS; Windows, Android, and Ubuntu receive community or experimental support. Each product is open-source under clearly defined licenses.

1. OneBox — Desktop Client

OneBox is a cross-platform desktop GUI application built on the open-source sing-box kernel. Source code is available at github.com/OneOhCloud/OneBox.

License

Apache License, Version 2.0

OneBox integrates with sing-box by invoking its binary and communicating via HTTP API, keeping the two components as separate processes with no derived-work relationship. As a result, the GPLv3 copyleft terms of sing-box do not propagate to OneBox.

Platform Support Tiers

macOS

Primary Support

Highest priority. All new features are first implemented and validated on macOS. Bug fixes are addressed promptly.

Windows

Community Support

Bug reports from users and the community are accepted and reviewed. Some issues may not be fixable due to Windows system complexity. Core functionality works normally.

Ubuntu

Experimental Support

Best-effort support. Non-core functionality is not guaranteed. Only LTS releases within the standard 5-year support window are supported.

Supported macOS Versions

macOS 15 Sequoia(2024)

Supported — until approx. Autumn 2027

macOS 26 Tahoe(2025)

Supported — until approx. Autumn 2028

OneBox maintains alignment with Apple's officially supported major macOS versions (typically the latest three). Reference: endoflife.date/macos

Supported Windows Versions

Windows 10 (22H2)

End of support Oct 14, 2025 — dropped

Windows 11 (24H2)

Supported — until Oct 13, 2026

Windows 11 (25H2)

Supported — until Oct 12, 2027

OneBox follows the Microsoft official support lifecycle. Windows 10 reached end-of-life on October 14, 2025; support was dropped simultaneously. Current recommended version: Windows 11 24H2 or 25H2. Reference: Microsoft Lifecycle Policy

Supported Ubuntu Versions

Ubuntu 22.04 LTSJammy Jellyfish

Standard support until April 2027

Ubuntu 24.04 LTSNoble Numbat

Standard support until April 2029

Only LTS releases within the standard 5-year support window are supported (Ubuntu Pro ESM extended maintenance is excluded). Reference: endoflife.date/ubuntu

Support Lifecycle Policy

Only officially supported LTS versions are covered — paid extended maintenance programs (e.g., Ubuntu Pro ESM, Windows ESU) are excluded.
Support windows are aligned with the shorter of: the OS vendor's official LTS support window, or the toolchain (compiler, runtime) support window.
Once an OS version or its toolchain reaches end of official support, OneBox simultaneously drops support — no backport bug fixes will be provided.

2. OneBoxM — Mobile Client

OneBoxM is a cross-platform mobile GUI application built on React Native, deeply integrating the sing-box kernel at the mobile platform layer. Source code is available at github.com/OneOhCloud/OneBoxRN.

License

GNU General Public License v3.0 (GPLv3)

Due to mobile platform architecture, OneBoxM requires deep linkage and integration with the sing-box core, creating a derived-work relationship. The GPLv3 copyleft terms therefore apply, and the entire project is distributed as open source under GPLv3.

Platform Support Tiers

iOS

Primary Support

Highest priority. All new features are first implemented and validated on iOS. Bug fixes are addressed promptly.

Android

Community Support

Bug reports from users are accepted and reviewed. Android fragmentation means some issues may be difficult to reproduce or fix. Core functionality works normally.

Supported iOS Versions

iOS 18

Currently supported

iOS 26(released 2025)

Currently supported

OneBoxM follows Apple's official major iOS support window. iOS support lifetime is tied to device hardware support, typically 5–7 years. Reference: endoflife.date/ios

Supported Android Versions

Android 13

Supported

Android 14

Supported

Android 15(latest)

Supported

Android 16(released 2025)

Supported

Android lacks a unified official LTS policy. OneBoxM supports versions within Google's active Android Security Bulletin coverage. Reference: endoflife.date/android

Support Lifecycle Policy

Support scope is based on Apple / Google official security bulletin coverage.
The shorter of the OS vendor's support window or the toolchain support window applies.
Once a version loses official vendor support, OneBoxM simultaneously drops support for that version.