Skip to content

Commit efdbb78

Browse files
authored
docs: add network error troubleshoot (#2178)
1 parent de9ee76 commit efdbb78

File tree

2 files changed

+17
-3
lines changed

2 files changed

+17
-3
lines changed

.github/ISSUE_TEMPLATE/bug_report.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,13 @@ assignees: ''
77

88
---
99

10+
<!--
11+
Please make sure this issue is not covered in our FAQ/Troubleshoot section:
12+
https://github.com/ipfs/ipfs-desktop#faq--troubleshooting
13+
-->
14+
1015
- OS: [e.g. macOS, Windows, Linux]
11-
- Version of IPFS Desktop [e.g. 0.20.0]
16+
- Version of IPFS Desktop [e.g. 0.20.0]
1217

1318
**Describe the bug**
1419
A clear and concise description of what the bug is.

README.md

+11-2
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ When in doubt, pick one of package formats with built-in automatic update mechan
5656
- [Which version of IPFS does IPFS Desktop use?](#which-version-of-ipfs-does-ipfs-desktop-use)
5757
- [Which flags does IPFS Desktop boot with?](#which-flags-does-ipfs-desktop-boot-with)
5858
- [I got a `repo.lock` error. How do I resolve this?](#i-got-a-repolock-error-how-do-i-resolve-this)
59+
- [I got a network error (e.g. `Error fetching`). What should I do?](#i-got-a-network-error-eg-error-fetching-what-should-i-do)
5960
- [I need more help!](#i-need-more-help)
6061
- [License](#license)
6162

@@ -242,10 +243,18 @@ You can change this in the IPFS Desktop config file by selecting `Open Configura
242243

243244
In general, this means that a previous process was unable to remove the repository lock (indicator that file is in use) from the repository directory. This is supposed to be handled automatically, but sometimes it isn't. If you get this error, you can generally safely delete this file after shutting down any running IPFS daemon's or applications. Simple process is as follows:
244245

245-
1. Stop ipfs processes
246-
2. Manually delete lock file, located within the [repository](#how-does-ipfs-desktop-select-the-ipfs-repo-location)
246+
1. Stop ipfs processes;
247+
2. Manually delete lock file, located within the [repository](#how-does-ipfs-desktop-select-the-ipfs-repo-location);
247248
3. Attempt to start ipfs desktop (or other process that received the `repo.lock` error) again.
248249

250+
### I got a network error (e.g. `Error fetching`). What should I do?
251+
252+
When upgrading, IPFS may need to perform migrations and for that we need a stable connection to download the required information for the migrations. Sometimes, the Internet connection may fail or be blocked by firewalls or antiviruses, and then you will run into a network error. Before submitting an issue, please try the following:
253+
254+
1. Check if you are connected to the Internet;
255+
2. Make sure your firewall or antivirus is not blocking requests, such as P2P traffic;
256+
3. Try again, by restarting IPFS Desktop.
257+
249258
### I need more help!
250259

251260
If you need help with using IPFS Desktop, the quickest way to get answers is to post them in the [official IPFS forums](https://discuss.ipfs.io).

0 commit comments

Comments
 (0)