troubleshooting.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

# Troubleshooting

These are some common issues when starting.

## “cargo-nextest” cannot be opened because the developer cannot be verified.

On Macs, unsigned binaries cannot be run by default. To manually approve this
app, go to: [Apple menu > System Preferences, click Security & Privacy, under the General tab](x-apple.systempreferences:com.apple.preference.security). You'll see "“cargo-nextest” was blocked from use because it is
not from an identified developer". Click the "Allow Anyway" button, and
`cargo-nextest` can be run on the next invocation.

See also: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac

## Cannot `pnpm install` because of oniguruma

Oniguruma does not provide a prebuilt binary for arm64 macOS. Further, macOS
does not provide a python2 environment by default anymore! You need to setup your
python environment, much like we would setup your node environment:

```shell
brew install pyenv
eval "$(pyenv init --path)"
pyenv install 2.7.18
pyenv local 2.7.18
```

Now try `pnpm install` again.

See also: https://stackoverflow.com/a/67274521

## Cannot `pnpm install` because of canvas

Canvas does not provide a prebuilt binary for arm64. To manually compile,
you can use Homebrew to install the necessary packages:

```shell
brew install python pkg-config pixman cairo pango
```

Now try `pnpm install` again.

See also: https://github.com/Automattic/node-canvas/blob/master/Readme.md#compiling