Skip to content

Commit 357cf35

Browse files
authored
update vi-docker-tutorial.md (fixes #3670) (#3675)
1 parent 88d5827 commit 357cf35

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

pages/vi/vi-docker-tutorial.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,26 @@ We suggest referring to the [Docker CLI reference](https://docs.docker.com/engin
191191

192192
You can also use `docker --help` and `docker compose --help` to see brief usage instructions for other commands you might need. Additionally, running `docker COMMAND --help` or `docker compose COMMAND --help` provides detailed information about a specific command.
193193

194+
### Troubleshooting
195+
196+
#### "403 Forbidden" or "pull access denied" errors when pulling from ghcr.io
197+
198+
Sometimes, pulling images from `ghcr.io` may fail with a `403 Forbidden` error. This is often due to network restrictions, firewalls, or geographical blocking.
199+
200+
**Possible solutions:**
201+
- Use a VPN to change your network IP address.
202+
- Try using a different network connection (e.g., a mobile hotspot).
203+
- Ask for help in the `#vi-software` Discord channel.
204+
205+
**Workaround:**
206+
If the issue persists, you can try using the Docker Hub image as an alternative:
207+
```yaml
208+
image: openlearningexchange/planet:6.0.0
209+
```
210+
211+
---
212+
213+
194214
## Useful Links
195215
196216
- [What is a Container? | Docker](https://www.docker.com/resources/what-container/)
@@ -204,3 +224,4 @@ You can also use `docker --help` and `docker compose --help` to see brief usage
204224
**→** Next: [Step 3.2 - Planet Configurations](vi-planet-configurations.md)
205225
206226
Return to [First Steps](vi-first-steps.md#Step_3_-_Planet_and_Docker)
227+

0 commit comments

Comments
 (0)