OWASP Juice Shop

The most trustworthy online shop out there. (@dschadow) — The best juice shop on the whole internet! (@shehackspurple) — Actually the most bug-free vulnerable application in existence! (@vanderaj) — First you 😂😂then you 😢 (@kramse) — But this doesn't have anything to do with juice. (@coderPatros' wife)

OWASP Juice Shop is probably the most modern and sophisticated insecure web application! It can be used in security trainings, awareness demos, CTFs and as a guinea pig for security tools! Juice Shop encompasses vulnerabilities from the entire OWASP Top Ten along with many other security flaws found in real-world applications!

For a detailed introduction, full list of features and architecture overview please visit the official project page: https://owasp-juice.shop

Table of contents

• Setup
  • From Sources
  • Packaged Distributions
  • Docker Container
  • Vagrant
• Demo
• Documentation
  • Node.js version compatibility
  • Troubleshooting
  • Official companion guide
• Contributing
• References
• Merchandise
• Donations
• Contributors
• Licensing

Setup

You can find some less common installation variations as well as instructions to run Juice Shop on a variety of cloud computing providers in the Running OWASP Juice Shop documentation.

Some challenges require an AI/LLM provider to work properly. Check the Setting up external dependencies documentation for instructions on configuring local or cloud-based AI providers.

From Sources

1. Install node.js
2. Run git clone https://github.com/juice-shop/juice-shop.git --depth 1 (or clone your own fork of the repository)
3. Go into the cloned folder with cd juice-shop
4. Run npm install (only has to be done before first start or when you change the source code)
5. Run npm start
6. Browse to http://localhost:3000

Packaged Distributions

1. Install a 64bit node.js on your Windows, MacOS or Linux machine
2. Download juice-shop-<version>_<node-version>_<os>_x64.zip (or .tgz) attached to latest release
3. Unpack and cd into the unpacked folder
4. Run npm start
5. Browse to http://localhost:3000

Each packaged distribution includes some binaries for sqlite3 and libxmljs2 bound to the OS and node.js version which npm install was executed on.

Docker Container

1. Install Docker
2. Run docker pull bkimminich/juice-shop
3. Run docker run --rm -p 127.0.0.1:3000:3000 bkimminich/juice-shop
4. Browse to http://localhost:3000 (on macOS and Windows browse to http://192.168.99.100:3000 if you are using docker-machine instead of the native docker installation)

Vagrant

1. Install Vagrant and Virtualbox
2. Run git clone https://github.com/juice-shop/juice-shop.git (or clone your own fork of the repository)
3. Run cd vagrant && vagrant up
4. Browse to 192.168.56.110

Demo

Feel free to have a look at the latest version of OWASP Juice Shop: http://demo.owasp-juice.shop

This is a deployment-test and sneak-peek instance only! You are not supposed to use this instance for your own hacking endeavours! No guaranteed uptime! Guaranteed stern looks if you break it!

Documentation

Node.js version compatibility