Skip to content

Commit

Permalink
[Documentation] Certificate and Valet+ troubleshooting updates (#637)
Browse files Browse the repository at this point in the history
* Add troubleshooting note about deleting devcert folder

* Add note about using Valet 1.0.21

* Update pwa-devdocs/src/pwa-buildpack/troubleshooting/index.md

Co-Authored-By: jcalcaben <jcalcaben@users.noreply.github.com>
  • Loading branch information
jcalcaben authored and supernova-at committed Dec 17, 2018
1 parent 3927f36 commit 949143a
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 2 deletions.
15 changes: 13 additions & 2 deletions pwa-devdocs/src/pwa-buildpack/troubleshooting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Another program or process has edited your [host file] and removed the entry for

**Browser does not trust the generated SSL certificate**{:#untrusted-ssl-cert}

Generating certificates is handled by [devcert]. It depends on OpenSSL, so make sure you have a current version of openssl on your system using the following command:
Generating certificates is handled by [devcert][]. It depends on OpenSSL, so make sure you have a current version of openssl on your system using the following command:

``` sh
openssl version
Expand All @@ -82,7 +82,18 @@ The version should be 1.0 or above (or LibreSSL 2, in the case of OSX High Sierr

You can install higher versions of OpenSSL with [Homebrew] on OSX, [Chocolatey] on Windows, or your Linux distribution's package manager.

If you're running Linux, machine make sure that `libnss3-tools` (or whatever the equivalent is) is installed on your system. Further information provided in [this section of the devcert readme].
If you're running Linux, make sure that `libnss3-tools` (or whatever the equivalent is) is installed on your system. Further information provided in [this section of the devcert readme][].

Some users have suggested deleting the `devcert` folder to trigger certificate regeneration.

* For MacOS users, this folder is usually found at:
```sh
~/Library/Application Support/devcert
```
* For Windows users, this folder is usually found at:
```text
${User}\AppData\Local\devcert
```

[create an issue]: https://github.com/magento-research/pwa-buildpack/issues
[Slack channel]: https://magentocommeng.slack.com/messages/C71HNKYS2/team/UAFV915FB/
Expand Down
3 changes: 3 additions & 0 deletions pwa-devdocs/src/venia-pwa-concept/setup/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,9 @@ Use the default cloud instance as the backend or set up your own [local developm
The Venia storefront has been verified to be compatible with the following local setups:

* Magento 2 installed using [valet-plus][]

**Note:** If you are having `Magento2ValetDriver` problems, try downgrading to version **1.0.21**.

* [Vagrant Box for Magento 2 developers][]

Don't forget to install the [Venia sample data][]!
Expand Down

1 comment on commit 949143a

@vercel
Copy link

@vercel vercel bot commented on 949143a Dec 17, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully aliased the URL https://magento-venia-pquayuuool.now.sh to the following alias.

Please # to comment.