# Troubleshooting

### Installation issues with mac

If you are on a mac system you will be prompted to verify the software to ensure it is from a trusted source. Follow the steps below to get `planeo` installed.

After you type `planeo start`, when prompted click on **"done"**.

<figure><img src="/files/KAWfuAhx7MD15Bbn554b" alt=""><figcaption></figcaption></figure>

This will add an entry for the application under **System Settings > Privacy & Security > App Store and identified developers**. Click **"Allow Anyway"**.

<figure><img src="/files/mu28yALlV2EGXFuiaIDT" alt=""><figcaption></figcaption></figure>

Go back to your CLI and type `./planeo start` again. This will open another prompt asking for verification again. Click **"Allow Anyway"** which should then prompt for an api key.&#x20;

<figure><img src="/files/JQuL3f2lT89jbzSm7siP" alt=""><figcaption></figcaption></figure>

### Open config.yaml: permission denied

If you see the following error, create a `.planeo` dir in your home dir or do a `rm -f /home/<username>/.planeo && mkdir /home/<username>/.planeo` and restart planeo.&#x20;

```
$ planeo start

██████╗ ██╗      █████╗ ███╗   ██╗███████╗ ██████╗ 
██╔══██╗██║     ██╔══██╗████╗  ██║██╔════╝██╔═══██╗
██████╔╝██║     ███████║██╔██╗ ██║█████╗  ██║   ██║
██╔═══╝ ██║     ██╔══██║██║╚██╗██║██╔══╝  ██║   ██║
██║     ███████╗██║  ██║██║ ╚████║███████╗╚██████╔╝
╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝ ╚═════╝

open /home/<username>/.planeo/config.yaml: permission denied
exit status 1
```


---

# Agent Instructions: 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:

```
GET https://documentation.planeo.dev/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.