Skip to content

Commit 9b31e09

Browse files
authored
docs(readme): add repo.lock troubleshooting steps to readme (#2111)
1 parent f5dd54f commit 9b31e09

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

README.md

+8
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,14 @@ By default, IPFS Desktop starts the IPFS daemon with the flags `--migrate=true -
212212

213213
You can change this in the IPFS Desktop config file by selecting `Open Configuration File` from the `Advanced` submenu.
214214

215+
### I got a `repo.lock` error. How do I resolve this?
216+
217+
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:
218+
219+
1. Stop ipfs processes
220+
2. Manually delete lock file, located within the [repository](#how-does-ipfs-desktop-select-the-ipfs-repo-location)
221+
3. Attempt to start ipfs desktop (or other process that received the `repo.lock` error) again.
222+
215223
### I need more help!
216224

217225
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)