Diagnostics at your fingertips

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.

Key Features

๐Ÿ”

Comprehensive Testing

Test all hardware components of your mobile Linux device

๐Ÿ“ฑ

Native Mobile UI

Built with GTK4/libadwaita or QT6/Kirigami for a native experience

๐Ÿ“Š

Detailed Reports

Validate your device and share your device condition with community

๐Ÿ†“

Free & Open Source

Licensed under GPL2, contributions welcome

Pick your TuxDoctor flavor

Same powerful diagnostics, three different interfaces โ€” choose what fits your workflow.

Qt Edition

Smooth, native-feeling UI powered by Qt6/Kirigami. Perfect for Plasma Mobile users.

โ–ถ
Demo video coming soon

GTK Edition

Built with GTK4 & libadwaita for a GNOME-native look on Phosh and similar shells.

โ–ถ
Demo video coming soon

CLI Edition

Zero GUI needed. Run full diagnostics over SSH or in any terminal environment.

โ–ถ
Demo video coming soon

Pick your Linux mobile OS

TuxDoctor is at home on the leading mobile Linux distributions.

Mobian logo

Mobian

Debian-based mobile Linux for phones and tablets.

Install TuxDoctor
# GTK edition
apt-get install tuxdoctor-gtk
# Qt edition
apt-get install tuxdoctor-qt
# CLI edition
apt-get install tuxdoctor-cli
postmarketOS logo

postmarketOS

Alpine-based, security-focused, works on hundreds of devices.

Install TuxDoctor
# GTK edition
apk add tuxdoctor-gtk
# Qt edition
apk add tuxdoctor-qt
# CLI edition
apk add tuxdoctor-cli
NixOS logo

Mobile NixOS

Declarative, reproducible mobile Linux powered by the Nix ecosystem.

Install TuxDoctor
# GTK edition
nix shell -p tuxdoctor-gtk
# Qt edition
nix shell -p tuxdoctor-qt
# CLI edition
nix shell -p tuxdoctor-cli

Privacy by Design

You control what leaves your device. Always.

{ }

Privacy FAQ

Your questions about data handling, answered plainly.

Does TuxDoctor send any data without my knowledge? โ€บ

Firstly test reports are local and set by default as opt-out from submitting them to the TuxDoctor database.

What data is included in the Full JSON report? โ€บ

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.

How does the Filtered JSON report protect my privacy? โ€บ

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.

What guarantees does the Ironseal protocol provide? โ€บ

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.

What is the license of the data stored in the Test report? โ€บ

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).

Test Report: Checks

Every check follows the same transparent flow โ€” from failure to fix to confirmation.

โœ— Fail

WiFi Test

time 5038 ms

Test failed

Failure Details

Check interface_detection
Message No WiFi adapter found

Here's a troubleshooting guide:

TuxDoctor identifies the failing component and displays the exact error for you.

๐Ÿ”ง Troubleshoot
tuxdoctor.com/checks/wifi

WiFi Troubleshooting Guide

  1. Check platform, wifi dtb node
  2. Check firmware present loaded
  3. Remote processor is running
  4. Kernel module/option present
  5. NetworkManager running
Full article on the TuxDoctor wiki โ†’

Follow the linked wiki guide with step-by-step commands to resolve the issue.

โœ“ Pass

WiFi Test

time 5077 ms

WiFi Adapter

Interface wlP6p1s0
Driver ath11k_pci
MAC Address 00:03:7f:12:3e:5a
Mode Managed โ€“ connected to "InstallFest26"

Found 14 WiFi Network(s)

InstallFest26 -51 dBm

2412 MHz (Ch 1)   WPA2

30:23:03:DE:45:19

Standards: 802.11b  802.11g  802.11n  802.11ax

FRITZ!Box 7590 -63 dBm

5220 MHz (Ch 44)   WPA2

E4:5D:51:F2:33:88

Standards: 802.11a  802.11n  802.11ac  802.11ax

TP-Link_5G_4A2B -67 dBm

5180 MHz (Ch 36)   WPA2

A4:2B:8C:11:5F:00

Standards: 802.11a  802.11n  802.11ac

AndroidAP_8721 -74 dBm

2437 MHz (Ch 6)   WPA2

52:A1:3C:00:9B:F4

Standards: 802.11b  802.11g  802.11n

BT-HomeHub-4E3F -81 dBm

2462 MHz (Ch 11)   WPA1 WPA2

C4:3A:BE:DD:1C:09

Standards: 802.11b  802.11g  802.11n

Re-run TuxDoctor to confirm the component now passes all checks.

Building a Global Community

Join us and get the most up-to-date and stable OS for your mobile device running Linux