Skip to content
Snippets Groups Projects
Commit 87b79a82 authored by Bjoern Kimminich's avatar Bjoern Kimminich
Browse files

Update troubleshooting tips for v8.x

parent 6c41a85a
No related branches found
No related tags found
No related merge requests found
# Troubleshooting [![Gitter](http://img.shields.io/badge/gitter-join%20chat-1dce73.svg)](https://gitter.im/bkimminich/juice-shop)
## Node.js / NPM / Bower
## Node.js / NPM
- After changing to a different Node.js version it is a good idea to
delete `npm_modules` and re-install all dependencies from scratch with
`npm install`
- If you are experiencing
[Error 128](https://github.com/bower/bower/issues/50) from some GitHub
repos during `bower install` execution, run `git config --global
url."https://".insteadOf git://` and try `npm install` again
- If during `npm install` the `sqlite3` no binaries can be downloaded
for your system, the setup falls back to building from source with
`node-gyp`. Check the
- If during `npm install` the `sqlite3` or `libxmljs` binaries cannot be
downloaded for your system, the setup falls back to building from
source with `node-gyp`. Check the
[`node-gyp` installation instructions](https://github.com/nodejs/node-gyp#installation)
for additional tools you might need to install (e.g. Python 2.7, GCC,
Visual C++ Build Tools etc.)
- If `npm install` fails on Ubuntu (e.g. while installing PhantomJS) you
might have to install a recent version of Node.js and try again.
- If `npm install` runs into a `Unexpected end of JSON input` error you might need to clean your NPM cache with `npm cache clean --force` and then try again
- If `npm install` fails on Ubuntu you might have to install a recent
version of Node.js and try again.
- If `npm install` runs into a `Unexpected end of JSON input` error you
might need to clean your NPM cache with `npm cache clean --force` and
then try again
## Docker
......@@ -38,14 +36,13 @@
OAuth related challenge!** If you want to manually make the OAuth
integration work to get the full user experience, follow these steps:
1. Add your server URL to variable `authorizedRedirectURIs` in
`/app/js/controllers/LoginController.js` using your URL for both
the property name and value.
2. Setup OAuth in Google
`/frontend/src/app/login/login.component.ts` using your URL for
both the property name and value.
2. Setup your own OAuth binding in Google
https://console.developers.google.com/apis/library by clicking
_Credentials_ and afterwards _Create credentials_.
3. Update the `clientId` variable in
`/app/js/controllers/LoginController.js` to use your new OAuth
client id from Google.
3. Update the `clientId` variable in `login.component.ts` to use your
new OAuth client id from Google.
4. Re-deploy your server. You will now have the option to login with
Google on the login page.
......@@ -57,6 +54,6 @@
## Miscellaneous
- You may find it easier to find vulnerabilities using a pen test tool.
I strongly recommend
We strongly recommend
[Zed Attack Proxy](https://code.google.com/p/zaproxy/) which is open
source and very powerful, yet beginner friendly.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please to comment