From 60a481857f90385e7b456d5c6c2ee93ab9cee040 Mon Sep 17 00:00:00 2001 From: Fedor Korotkov Date: Fri, 3 Jan 2025 14:05:50 -0500 Subject: [PATCH] FAQ to help with troubleshooting (#988) --- docs/faq.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/faq.md b/docs/faq.md index 16a237d..8c5d616 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -5,6 +5,16 @@ title: Frequently Asked Questions description: Advanced configuration and troubleshooting tips for advanced configurations. --- +## Troubleshooting crashes + +If you experience a crash or encounter another error while using the tart executable, you can collect debug information to assist with troubleshooting. Run the following command in a separate terminal window to gather logs from the Tart process and the macOS Virtualization subsystem: + +```shell +log stream --predicate='process=="tart" OR process CONTAINS "Virtualization"' > tart.log +``` + +While the events are being streamed, attempt to reproduce the issue. Once the issue is reproduced, stop the streaming by pressing Ctrl+C. Then, attach the tart.log file to your report. + ## VM location on disk Tart stores all its files in `~/.tart/` directory. Local images that you can run are stored in `~/.tart/vms/`.