Skip to content

Commit

Permalink
feat: improve install debugging section
Browse files Browse the repository at this point in the history
  • Loading branch information
peaklabs-dev committed Dec 5, 2024
1 parent 48f3c71 commit f5d6c63
Showing 1 changed file with 20 additions and 4 deletions.
24 changes: 20 additions & 4 deletions src/content/docs/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -272,11 +272,27 @@ Coolify Proxy is still not working on Windows.
## Debugging

### Expired GitHub Personal Access Token
If you encounter an error like `Error response from daemon: Head "https://ghcr.io/v2/coollabsio/coolify-helper/manifests/1.0.1": unauthorized: authentication required`, it means Docker cannot access the GitHub Container Registry.
You might encounter one of these errors:

To fix this, either:
- Log out of the GitHub Container Registry or
- Renew your GitHub Personal Access Token
```bash
Error response from daemon: Head "https://ghcr.io/v2/coollabsio/coolify-helper/manifests/1.0.1": unauthorized: authentication required
```

or

```bash
Unable to find image 'ghcr.io/coollabsio/coolify-helper:latest' locally
docker: Error response from daemon: Head "https://ghcr.io/v2/coollabsio/coolify-helper/manifests/latest": denied: denied
```

These errors indicate that Docker cannot authenticate with the GitHub Container Registry (ghcr.io). To resolve this, you can either:

1. Log out of the GitHub Container Registry (ghcr.io):
```bash
docker logout ghcr.io
```

2. Or renew your GitHub Personal Access Token (PAT) if you need to maintain authenticated access for deployments for example.

### Raspberry Pi Crashes
If you are using a Raspberry Pi with only 2GB of RAM, you may experience system crashes even with swap space enabled. This probably occurs because Raspberry PIs often use SD cards which are slower than SSDs and can be unstable.
Expand Down

0 comments on commit f5d6c63

Please sign in to comment.