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

# 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
```