> 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

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 14 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.