Device diagnostics for your mobile Linux phone
Whether you want a full device check or just a specific peripheral test, TuxDoctor provides a guided, semi-automatic workflow. Most tests run automatically, while a few may ask for simple user input — all accompanied by clear instructions and easy-to-understand results.
Test all hardware components of your mobile Linux device
Built with GTK4/libadwaita or QT6/Kirigami for a native experience
Validate your device and share your device condition with community
Licensed under GPL2, contributions welcome
TuxDoctor is at home on the leading mobile Linux distributions.
Debian-based mobile Linux for phones and tablets.
apt-get install tuxdoctor-gtk
apt-get install tuxdoctor-qt
apt-get install tuxdoctor-cli
You control what leaves your device. Always.
Reports are cryptographically signed with the Ironseal protocol, guaranteeing authenticity and tamper-evidence from device to recipient.
Learn about Ironseal →
{ }
Your questions about data handling, answered plainly.
Firstly test reports are local and set by default as opt-out from submitting them to the TuxDoctor database.
The Full JSON report captures the results of all the test that were scheduled to run on that particular device. It contains device identifiers such as SoC serial number, MAC address and other along with the scanned networks, bluetooth, USB device, etc.
The full test report is not send, it's filtered first and personal identifiers are removed, see here the filters, that are also user customizable. This removes the device identifiers and scanned networks, bluetooth devices, etc.
The Ironseal protocol creates a random ed25519 keypair, submits the public key to the endpoint database and uploads test report signed by the private key. With your public key anyone can validate the data stored in teh git repo. No email, username or phone number is needed for the association. It's anonymous and allows to limit the spam. However, you can also claim your test reports and associate your ID (like Gitlab) with the data. For more information visit the Ironseal Rust crate.
As the nature of the data stored in the Test Report is technical the most suitable license is Creative Commons Attribution 4.0 International (CC BY 4.0).
Every check follows the same transparent flow — from failure to fix to confirmation.
https://tuxdoctor.com/checks/wifi
TuxDoctor identifies the failing component and displays the exact error for you.
Follow the linked wiki guide with step-by-step commands to resolve the issue.
Re-run TuxDoctor to confirm the component now passes all checks.
Join us and get the most up-to-date and stable OS for your mobile device running Linux