Welcome to the UKey hardware wallet. To ensure your digital asset management environment meets the highest security standards, and to guarantee absolute stability in communication between your UKey hardware device and the terminal, please verify the following official environment compatibility specifications before client deployment.
1. Desktop Operating Environment
The UKey Wallet desktop client provides native support for multiple platforms. Please ensure your operating system meets the following minimum version requirements:
Operating System | Minimum System Requirements | Recommended System Requirements | Architecture Notes |
macOS | 10.15 Catalina | 13 Ventura and above | Natively compatible with Intel and Apple Silicon (M1/M2/M3) chips |
Windows | Windows 10 (Version 1809) | Windows 11 | Standard x86/x64 architecture processors recommended |
Linux | Ubuntu 18.04 / Debian 10 / Fedora 32 / RHEL 8 | Ubuntu 22.04 LTS and above | Compatible with mainstream distributions |
2. Mobile Operating Environment
Operating System | Minimum System Requirements | Recommended System Requirements |
iOS / iPadOS | iOS 15.5 | iOS 17 and above |
Android | Android 7.0 | Android 13 and above |
UKey Official Security Policy Statement:
To prevent the leakage of critical data (such as private key caches) caused by the abuse of underlying system permissions, UKey Wallet implements strict runtime environment detection. Running this application on high-risk devices that are jailbroken (iOS) or rooted (Android) is strictly prohibited. Forcing the application to run may result in the triggering of security lockdown mechanisms or unexpected application termination.
3. Browser Extension & WebUSB Hardware Communication Support
When interacting with DApps via the web or browser extensions, the UKey hardware relies on the browser's WebUSB API to establish a secure HTTPS direct data connection. Due to differing support policies for underlying APIs among major browser vendors, please refer to the following compatibility matrix:
3.1 Officially Recommended & Supported Browsers (Chromium-based)
Google Chrome: Fully supported (Version 61 and above)
Microsoft Edge: Fully supported (Version 79 and above)
Official Recommendation: Please always keep your browser updated to the latest version to receive the most recent zero-day security patches.
3.2 Unsupported Browsers (Unable to call hardware APIs)
The following browsers cannot recognize and connect to UKey hardware devices due to kernel limitations. Please avoid using them for hardware interactions:
Firefox
Safari
Opera
Samsung Internet
QQ Browser
Internet Explorer (IE)
UC Browser (⚠️ Known Risk: Attempting to call hardware interfaces within the UC Browser environment will cause the browser process to crash unexpectedly.)
3.3 Mobile Web Interaction Restrictions
Android Environment: Using Chromium-based browsers on Android (such as mobile Chrome/Edge) allows for normal WebUSB hardware communication.
iOS Environment (Restricted): Subject to Apple's official underlying security policies, all web browsers on the iOS platform (including Chrome and Edge for iOS) do not support the WebUSB interface. iOS users needing to manage assets and sign transactions must use the official UKey App directly. Please do not attempt to connect the hardware via an iOS mobile browser.
4. Physical Interface & Device Communication Specifications
To ensure the hardware device can stably and securely transmit encrypted signing instructions to the client, please confirm the following physical connection conditions:
Wired Connection: Please use the original USB-A or USB-C data cable provided with the device to connect directly to your computer's motherboard port. UKey officially advises against using third-party, low-quality USB hubs or docking stations to prevent packet loss caused by unstable power supply voltage or signal attenuation.
Mobile Communication:
Direct Wired Connection: Android phones must have the OTG data transmission function enabled in the system settings.
Wireless Connection: Please confirm that the mobile device has Bluetooth enabled and has granted the necessary Bluetooth communication permissions to the UKey App.
5. System Resource Reservation
To ensure smooth client deployment, secure storage of local encrypted data, and seamless future Over-The-Air (OTA) firmware updates for your UKey hardware, we recommend reserving at least 500MB of available disk space on your terminal device.