# Debug desktop launcher (Windows)

- Link: https://www.agilicus.com/faq/debug-desktop-launcher-windows/
- Published: 2025-09-08T19:43:52+00:00
- Author: Don Bowman

**Diagnosing a Single PC Issue**

If you’re experiencing a problem with your Agilicus Agent on a single PC, these 
are the primary diagnostic steps you can take:

 1. **Review Log Files:**
    First, check the contents of the log files located in your
    agent’s logs directory. These files often contain valuable information about recent
    activities and errors.
 2.  * **Path:** `%LOCALAPPDATA%\Agilicus\Agent\logs`
     * **What to look for:** Examine the most recent log files for any error messages,
       warnings, or unexpected behavior.
 3. **Run a Debug Refresh:**
    If the log files don’t reveal the issue, you can force
    a client refresh with debug logging enabled. This can provide more detailed output
    about the agent’s operation.
 4.  * **Steps:**
        a. Open a `cmd` (Command Prompt) window.
        b. Run the following command:
           `%LOCALAPPDATA%\Agilicus\Agent\agilicus-agent.exe
           client --cfg-file %LOCALAPPDATA%\Agilicus\Agent\agent.conf.enc.yaml --client-
           refresh true --debug`
     * **Sharing Results (Optional):** If you need to share the results of this debug
       refresh with Agilicus support, you can append the following to the command to
       save the output to a file:
       `%LOCALAPAPPDATA%\Agilicus\Agent\agilicus-agent.exe
       client --cfg-file %LOCALAPPDATA%\Agilicus\Agent\agent.conf.enc.yaml --client-
       refresh true --debug > "%USERPROFILE%\Desktop\debug.log" 2>&1`After running 
       this, a file named `debug.log` will be created on your desktop, which you can
       then share.
 5. **Debug a Specific Launcher:**
    If the previous steps don’t identify the problem,
    you can debug the specific launcher directly. This allows you to see any issues
    related to its specific command execution.
 6.  * **Steps:**
        a. Locate the shortcut icon for the specific launcher you are having trouble with(
           e.g., on your desktop or Start Menu).
        b. Right-click the shortcut and select “Properties.”
        c. In the “Shortcut” tab, find the “Target” field. This field contains the full
           command line used to launch the application.
        d. Copy the entire command line from the “Target” field.
        e. Open a `cmd` (Command Prompt) window **as your regular user (not as an administrator)**.
        f. Paste the copied command line into the `cmd` window.
        g. Append `--debug` to the end of the command line.
        h. Press Enter to run the command.
     * This will execute the launcher with debug logging, and any remaining issues 
       or output will be displayed directly in the command prompt window.