{"id":12549,"date":"2026-08-03T10:06:50","date_gmt":"2026-08-03T08:06:50","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=12549"},"modified":"2026-08-03T10:06:54","modified_gmt":"2026-08-03T08:06:54","slug":"debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/","title":{"rendered":"Debian Desktop Troubleshooting Checklist: Boot, Network, Audio, Graphics, and Sleep"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\">\n<p class=\"wp-block-paragraph\">When a Debian desktop stops working after installation, start with the symptom and collect evidence before changing packages, drivers, repositories, or the installation itself. A short, ordered check can help separate a boot problem from a desktop, network, audio, graphics, suspend, or external-device problem.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Record what changed before the failure appeared. Include the Debian version, the installation image used, the computer or device model, processor architecture, and the exact error text. Debian downloads can differ by architecture, such as amd64 or arm64, and by image type, such as Live, Netinst, or Full. Keep this information with any logs you collect.<\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#Start_with_a_safe_evidence_check\" >Start with a safe evidence check<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_Debian_does_not_boot\" >If Debian does not boot<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_Wi-Fi_or_wired_network_access_fails\" >If Wi-Fi or wired network access fails<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_audio_does_not_work\" >If audio does not work<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_the_display_or_graphics_fail\" >If the display or graphics fail<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_suspend_or_wake_fails\" >If suspend or wake fails<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#If_an_external_device_is_not_detected\" >If an external device is not detected<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/debian-desktop-troubleshooting-checklist-boot-network-audio-graphics-and-sleep\/#When_to_escalate\" >When to escalate<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Start_with_a_safe_evidence_check\"><\/span>Start with a safe evidence check<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Describe the symptom.<\/strong> Write down what happens, when it happens, and whether the failure is repeatable. Note whether the problem affects the whole system or only one desktop application.<\/li>\n\n\n\n<li><strong>Record recent changes.<\/strong> Include system updates, newly installed software, driver changes, connected devices, display changes, and hardware changes.<\/li>\n\n\n\n<li><strong>Collect hardware details.<\/strong> Record the computer model, processor architecture, graphics hardware, network hardware, audio hardware, display connections, and external devices in use.<\/li>\n\n\n\n<li><strong>Save exact messages.<\/strong> Take a photo or copy any boot message, desktop notification, error dialog, or login failure. Collect the relevant system logs without editing them.<\/li>\n\n\n\n<li><strong>Make one change at a time.<\/strong> Restart or reconnect only the affected item first, then test again. Record the result before trying another change.<\/li>\n<\/ol>\n\n\n\n<\/div>\n\n<div id=\"mybox-1718334584\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">Avoid random commands, broad package removal, repository changes, and a full reinstall while the cause is still unknown. These actions can remove useful evidence or create a second problem.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_Debian_does_not_boot\"><\/span>If Debian does not boot<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">First identify where the process stops. Separate a computer that shows no power or display from one that reaches the boot menu, login screen, or desktop and then fails.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If there is no visible output, check the power state, display connection, and selected monitor input. Record whether the system produces any message or response.<\/li>\n\n\n\n<li>If a boot menu appears, note the selected entry and the exact point where startup stops.<\/li>\n\n\n\n<li>If the login screen appears but the desktop does not load, record whether the problem affects one user session or every session.<\/li>\n\n\n\n<li>If the system starts after a restart but fails again later, record what happened immediately before the failure.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Use the saved boot messages and system logs when asking for help. Do not change repositories or reinstall Debian until the failure point and available evidence have been identified.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_Wi-Fi_or_wired_network_access_fails\"><\/span>If Wi-Fi or wired network access fails<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Check whether the issue affects Wi-Fi, a wired connection, or both. Record whether the network is visible, whether connection attempts fail, and whether the desktop reports a specific error.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check that the network device is enabled in the desktop controls.<\/li>\n\n\n\n<li>For Wi-Fi, record whether the expected network appears in the list and whether other networks are visible.<\/li>\n\n\n\n<li>For wired access, check the cable and the connection status shown by the desktop.<\/li>\n\n\n\n<li>Test again after a restart and record whether the result changes.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Collect the network hardware details, connection status, and related logs. Avoid changing several network settings at once because the original state may be needed for diagnosis.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_audio_does_not_work\"><\/span>If audio does not work<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Check whether audio is missing from all applications or only one. Verify that the intended output device is selected and that the system and application volume controls are not muted.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Record the output device name, whether headphones or speakers are connected, and whether the device appears in the desktop audio controls. If audio changes when an external display is connected, record that connection as part of the symptom. Save any audio-related error messages and logs before changing packages or drivers.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_the_display_or_graphics_fail\"><\/span>If the display or graphics fail<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Record whether the screen is blank, flickers, shows a low resolution, displays visual errors, or fails only after login. Note whether the issue changes with a different monitor, cable, port, or display connection.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Collect the graphics hardware details, monitor details, connection type, and the point in startup where the problem appears. A failure before login and a failure after the desktop loads may have different causes, so keep those symptoms separate.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_suspend_or_wake_fails\"><\/span>If suspend or wake fails<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Record what happens when the computer enters suspend and when it should wake. Note whether the screen remains blank, whether the keyboard or power button responds, and whether a forced restart is needed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">List connected external devices and any recent display, graphics, kernel, or hardware changes. Collect logs from the session before the failed wake when possible. Test one change at a time and avoid repeated forced restarts unless the system is unresponsive.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"If_an_external_device_is_not_detected\"><\/span>If an external device is not detected<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Identify the device type, connection method, model, and the exact symptom. Record whether the device is visible in the desktop, whether it works through another port, and whether it works after a restart.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Disconnect unrelated devices, reconnect the affected device, and test again. Keep a record of each connection change. Include the device details and relevant system logs when escalating.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"When_to_escalate\"><\/span>When to escalate<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Contact support or a Debian administrator when the failure remains after the low-risk checks, when the system cannot boot, or when logs contain repeated errors that you cannot interpret safely. Provide the symptom, timeline, hardware details, Debian image details, exact messages, collected logs, and every change already tested.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">That evidence makes the next step more focused. It also reduces the need to reinstall Debian or change repositories before the underlying problem is understood.<\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[42],"manual_kb_tag":[],"class_list":["post-12549","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-miscellaneous"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/12549","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/12549\/revisions"}],"predecessor-version":[{"id":12550,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/12549\/revisions\/12550"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=12549"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=12549"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=12549"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}