---
title: How to Locate AI Chat Copilot Log Files
description: Learn how to enable Debug Mode in AI Chat Copilot and locate the astah-copilot.log file on Windows and macOS for bug submissions.
---

[Skip to content](https://lp.astah.net/en/knowledge-base/ai-chat-copilot-log-location#main-content)

English

Show submenu for translations

[![AstahLogo\_blue](https://lp.astah.net/hubfs/AstahLogo_blue.svg)](https://lp.astah.net/en/knowledge-base?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Astah Website](https://astah.net/)

[Astah Website](https://astah.net/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Astah Help Center](https://lp.astah.net/en/knowledge-base?hsLang=en)
2. [Reporting a Bug in Astah](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en)
3. [AI Chat Copilot / Diagnostic Data](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en#ai-chat-copilot-diagnostic-data)

# How to Locate AI Chat Copilot Log Files

## Enabling debug mode and finding the astah-copilot.log file for error reporting.

If you encounter an issue while using the AI Chat Copilot, the Astah support team may request a specific log file called `astah-copilot.log` to investigate the bug. To ensure this file contains the necessary diagnostic data, you must first enable **Debug Mode**.

### 1. Enable Debug Mode

Before collecting the log, follow these steps to capture the technical details of the error:

1. Open the **Settings** menu within the AI Chat Copilot view.  
   ![ChatCopilot\_Settings-1536x1219](https://lp.astah.net/hs-fs/hubfs/Imported%20sitepage%20images/ChatCopilot_Settings-1536x1219.png?width=573&height=455&name=ChatCopilot_Settings-1536x1219.png)
2. Navigate to the **General** tab.
3. Check the **\[Debug Mode\]** box and click **\[OK\]**.  
   ![AI\_Chat\_Log-768x625](https://lp.astah.net/hs-fs/hubfs/Imported%20sitepage%20images/AI_Chat_Log-768x625.png?width=503&height=409&name=AI_Chat_Log-768x625.png)
4. **Reproduce the issue:** Run your prompt or action again. This ensures the relevant error data is written to the log.

---

### 2. Log File Location

After reproducing the error, the `astah-copilot.log` file can be found in the directory corresponding to your Astah edition.

| **Edition** | **Directory Folder** |
| --- | --- |
| **Astah Professional** | `professional` |
| **Astah UML** | `uml` |
| **Astah SysML** | `astahsysml` |
| **Astah System Safety** | `astahsystemsafety` |

#### Directory Paths

**USER\_HOME\\.astah\\ \< edition\_folder\>**  
Because the `.astah` folder starts with a dot, it is hidden by default on most systems. 

- [Astah License FAQ: Activation & Renewal](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#main-content)

    - [License Management](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#license-management)
    - [License Renewal](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#license-renewal)
    - [License Renewal - Perpetual](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#license-renewal-perpetual)
    - [Academic](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#academic)
    - [Product Evaluation](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#product-evaluation)
    - [Usage Rights](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#usage-rights)
    - [Free Student License](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#free-student-license)
    - [License Delivery](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#license-delivery)
    - [License Activation](https://lp.astah.net/en/knowledge-base/astah-license-faq-activation-renewal?hsLang=en#license-activation)
- [ChangeVision Members Account FAQ](https://lp.astah.net/en/knowledge-base/changevision-members-account-faq?hsLang=en#main-content)

    - [Account Management](https://lp.astah.net/en/knowledge-base/changevision-members-account-faq?hsLang=en#account-management)
    - [Access & Authentication](https://lp.astah.net/en/knowledge-base/changevision-members-account-faq?hsLang=en#access-authentication)
- [Buying Astah: Orders, VAT & Discounts](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#main-content)

    - [Post-Purchase Support](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#post-purchase-support)
    - [Purchasing & Payments](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#purchasing-payments)
    - [Subscription Management](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#subscription-management)
    - [Tax & Invoicing](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#tax-invoicing)
    - [Pricing & Discounts](https://lp.astah.net/en/knowledge-base/buying-astah-orders-vat-discounts?hsLang=en#pricing-discounts)
- [Astah Installation & Setup FAQ](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#main-content)

    - [Download & Installation](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#download-installation)
    - [Environment Settings](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#environment-settings)
    - [License Activation](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#license-activation)
    - [AI Configuration](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#ai-configuration)
    - [AI Chat Copilot / MCP Server](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#ai-chat-copilot-mcp-server)
    - [Integrations & Plugins](https://lp.astah.net/en/knowledge-base/astah-installation-setup-faq?hsLang=en#integrations-plugins)
- [Astah Feature Guides & Modeling Tips](https://lp.astah.net/en/knowledge-base/astah-feature-guides-modeling-tips?hsLang=en#main-content)

    - [Export / Printing](https://lp.astah.net/en/knowledge-base/astah-feature-guides-modeling-tips?hsLang=en#export-printing)
- [Diagram Editing in Astah: How-To FAQ](https://lp.astah.net/en/knowledge-base/diagram-editing-in-astah-how-to-faq?hsLang=en#main-content)

    - [Activity Diagrams / Statemachine Diagrams](https://lp.astah.net/en/knowledge-base/diagram-editing-in-astah-how-to-faq?hsLang=en#activity-diagrams-statemachine-diagrams)
- [Using the Astah Interface: FAQ](https://lp.astah.net/en/knowledge-base/using-the-astah-interface-faq?hsLang=en#main-content)

    - [Basics / General Operations](https://lp.astah.net/en/knowledge-base/using-the-astah-interface-faq?hsLang=en#basics-general-operations)
- [Astah Product Specs & Compatibility](https://lp.astah.net/en/knowledge-base/astah-product-specs-compatibility?hsLang=en#main-content)

    - [Compatibility & Interoperability](https://lp.astah.net/en/knowledge-base/astah-product-specs-compatibility?hsLang=en#compatibility-interoperability)
- [Getting Technical Support for Astah](https://lp.astah.net/en/knowledge-base/getting-technical-support-for-astah?hsLang=en#main-content)

    - [Support Services](https://lp.astah.net/en/knowledge-base/getting-technical-support-for-astah?hsLang=en#support-services)
    - [File Handling & Security](https://lp.astah.net/en/knowledge-base/getting-technical-support-for-astah?hsLang=en#file-handling-security)
- [Troubleshooting Common Astah Issues](https://lp.astah.net/en/knowledge-base/troubleshooting-common-astah-issues?hsLang=en#main-content)

    - [Feature Access / Plugins](https://lp.astah.net/en/knowledge-base/troubleshooting-common-astah-issues?hsLang=en#feature-access-plugins)
    - [Diagram Editor](https://lp.astah.net/en/knowledge-base/troubleshooting-common-astah-issues?hsLang=en#diagram-editor)
- [Astah Software Updates & Upgrades](https://lp.astah.net/en/knowledge-base/astah-software-updates-upgrades?hsLang=en)
- [Reporting a Bug in Astah](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en#main-content)

    - [Diagnostic Data](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en#diagnostic-data)
    - [Submission Guidelines](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en#submission-guidelines)
    - [AI Chat Copilot / Diagnostic Data](https://lp.astah.net/en/knowledge-base/reporting-a-bug-in-astah?hsLang=en#ai-chat-copilot-diagnostic-data)

[![Chill listening crop-3](https://lp.astah.net/hs-fs/hubfs/astah-transparent.png?width=55&height=24&name=astah-transparent.png "Chill listening crop-3")](https://astah.net/)

Provided by Change Vision, Inc.

<https://www.facebook.com/astah.changevision/> <https://twitter.com/astah_en> <https://www.youtube.com/c/ChangeVision-Astah-modeling/videos>

Copyright © 2026, Change Vision, Inc.