Skip to content

Commit 2ec7924

Browse files
committed
fix: startup on Debian 10
This disables sandboxing in ipfs-desktop.desktop manifest which is ised by Desktop Environments for generating menus and icons used for starting apps. Rationale can be found at: #1362 (comment) License: MIT Signed-off-by: Marcin Rataj <[email protected]>
1 parent b04f9dd commit 2ec7924

File tree

4 files changed

+221
-256
lines changed

4 files changed

+221
-256
lines changed

README.md

+26
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ IPFS Desktop allows you to run your IPFS Node on your machine without having to
3030
- [Contribute](#contribute)
3131
- [Translations](#translations)
3232
- [FAQ](#faq)
33+
- [Troubleshooting](#troubleshooting)
3334

3435
## Features
3536

@@ -164,6 +165,31 @@ Since we're using [ipfsd-ctl](https://github.com/ipfs/js-ipfsd-ctl), we have our
164165

165166
By default we use the flags `--migrate=true --routing=dhtclient ----enable-gc=true` when running the IPFS daemon. They can be changed via the configuration file, which can be easily accessed as mentioned above.
166167

168+
## Troubleshooting
169+
170+
### Does not start on Linux (Debian 10)
171+
172+
Some Linux users may see an error like this:
173+
174+
> The SUID sandbox helper binary was found, but is not configured correctly.
175+
Rather than run without sandboxing I'm aborting now. You need to make sure that
176+
chrome-sandbox is owned by root and has mode 4755.
177+
178+
or a very short one, when starting in a terminal:
179+
180+
```console
181+
$ ipfs-desktop
182+
$Trace/breakpoint trap
183+
```
184+
185+
186+
**TL;DR** There are two ways of fixing this, pick one that works for you:
187+
188+
1. Change your kernel settings: `sudo sysctl kernel.unprivileged_userns_clone=1`
189+
2. Disable the sandbox with commandline parameter: `ipfs-desktop --no-sandbox`
190+
191+
If you are interested in the history of Chrome sandboxing issues on Linux, read [this](https://github.com/ipfs-shipyard/ipfs-desktop/issues/1362#issuecomment-596857282).
192+
167193
## License
168194

169195
[MIT Protocol Labs, Inc.](./LICENSE)

electron-builder.yml

+2
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ nsis:
3535
linux:
3636
artifactName: ${name}-${version}-${os}-${arch}.${ext}
3737
executableName: ipfs-desktop
38+
executableArgs:
39+
- --no-sandbox
3840
icon: ipfs-desktop
3941
category: Network;FileTransfer;P2P
4042
synopsis: A desktop client for IPFS

0 commit comments

Comments
 (0)