> 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/installation-issues.md).

# Installation issues

Fix Play Protect warnings, sideload errors, and failed installs.

Android can block Lawnchair installation for a few common reasons.

This usually happens when you sideload an APK from the GitHub or Nightly release channels.

### Play Protect blocking installation

Google Play Protect scans apps for potential harm.

When you install Lawnchair from outside the Play Store, Play Protect may warn you or block the install.

To continue:

1. When prompted by Play Protect, tap **Install anyway**.
2. If installation is blocked without this option:
   1. Open the Play Store app.
   2. Tap your profile icon.
   3. Tap **Play Protect**, then tap **Settings** <i class="fa-gear">:gear:</i>.
   4. Tap **Scan apps with Play Protect**.
   5. On the message that appears, tap **Pause** or **Turn off**.
   6. Install Lawnchair.
   7. Turn Play Protect back on as soon as installation finishes.

### "App not installed" error

This is a generic Android error with several possible causes when you sideload an APK.

<details>

<summary>Check if you downloaded from an official source</summary>

You might have downloaded an APK file that has been modified or originates from an unofficial source. These often have different digital signatures that prevent installation.

**Solution:** Download Lawnchair from an official source listed in [Choosing a version](/getting-started/choose-a-version.md).

</details>

<details>

<summary>Check your downloaded file</summary>

The APK file you downloaded might be incomplete or damaged.

**Solution:** Delete the APK, then download it again.

</details>

<details>

<summary>Check your Lawnchair version</summary>

You might be trying to install an older version over a newer one, especially with Nightly builds.

**Solution:** Uninstall the newer version first, then install the older one.

</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/installation-issues.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.