> For the complete documentation index, see [llms.txt](https://docs.lawnchair.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lawnchair.app/troubleshooting/crashes.md).

# Crashes

Capture crash logs and try the fastest recovery steps.

If Lawnchair crashes, you can usually capture a report and share it with the team.

### How Lawnchair handles crash reports

Lawnchair includes automatic crash reporting.

When the app crashes, you will usually get a notification that lets you generate a shareable crash log link.

{% hint style="warning" %}
On Android 13 and newer, you must have **notifications** turned on for Lawnchair to receive these crash reports.
{% endhint %}

### How to capture and report a crash

1. When you see the Lawnchair crash notification, tap **Upload file**.
2. A unique link to the crash log will be generated. Tap **Copy to clipboard**.
3. Report the crash on GitHub:
   1. Navigate to our [GitHub bug report form](https://github.com/LawnchairLauncher/lawnchair/issues/new?template=bug_report.yaml).
   2. Follow the steps in the form.
      1. In the "Additional Information" section of the form, paste the crash log link you copied in step 2.
   3. Submit the form.

### Basic troubleshooting steps for frequent crashes

If Lawnchair is crashing frequently, try these general steps:

<details>

<summary>Restart Lawnchair</summary>

1. Long press on the home screen, then tap <i class="fa-house">:house:</i> **Home settings**.
2. On the screen that appears, tap **More** <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>.
3. Tap **Restart Lawnchair**.

</details>

<details>

<summary>Clear the app cache</summary>

1. Open **Home settings**.
2. Tap **More** <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>.
3. Tap **App info**.
4. Open **Storage and cache**.
5. Tap **Clear cache**.

</details>

<details>

<summary>Restart your device</summary>

1. On most phones, press your phone's power button for about 30 seconds, or until your phone restarts.
2. If prompted, tap **Restart** <i class="fa-repeat">:repeat:</i>.

</details>

<details>

<summary>Consider resetting Lawnchair to its default settings</summary>

**Important:** Resetting Lawnchair removes your custom settings and layout.

Before you do this, create a backup.

See [Backup, restore, and reset](/core-features/backup-restore-and-reset.md).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lawnchair.app/troubleshooting/crashes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.