Skip to content

Commit 5e3811a

Browse files
authored
Update troubleshooting.md
The Homebrew installation is based on a so-called keg-only formula, which means that symlinks in `/usr/local` are _not_ established. Note that with Homebrew installed, `sudo` is _not_ needed to create the symlinks in the `/usr/local` subtree.
1 parent 6237500 commit 5e3811a

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

docs/troubleshooting.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,23 @@ the following two files:
1717
```
1818

1919
The extension should check for these files and direct you to this documentation if you
20-
do not have OpenSSL isntalled.
20+
do not have OpenSSL installed.
2121

2222
#### Installing OpenSSL via Homebrew
2323

24-
You can use Homebrew to easily install OpenSSL. First install Homebrew and then run the following command:
24+
You can use [Homebrew](http://brew.sh) to easily install OpenSSL. First, install Homebrew and then run the following command:
2525

2626
```
2727
brew install openssl
2828
```
2929

30+
After installation, the libraries of interest must be symlinked to `/usr/local/lib`; e.g. (adjust the version numbers as needed):
31+
32+
```
33+
ln -s /usr/local/Cellar/openssl/1.0.2h_1/lib/libcrypto.1.0.0.dylib /usr/local/lib
34+
ln -s /usr/local/Cellar/openssl/1.0.2h_1/lib/libssl.1.0.0.dylib /usr/local/lib
35+
```
36+
3037
Restart VS Code after completing the installation and verify that the extension is working correctly.
3138

3239
#### Installing OpenSSL via MacPorts

0 commit comments

Comments
 (0)