Skip to content

Manual Shepherd Setup

ismisepaul edited this page Oct 26, 2026 · 4 revisions

Important

This wiki is being retired. The Security Shepherd documentation has moved to https://owasp.github.io/SecurityShepherd/. This page describes older versions of Security Shepherd, and will be replaced by a link to the new site once 4.0 is released.

Before Setting up Shepherd

You need to have the following things installed and setup locally before Setting up Shepherd;

  1. Tomcat Server 8.5 (Recommended to configure SSL connections as well)
  2. MariaDb Server 10.6 (Create an admin shepherd user as well)

The Shepherd Setup

  1. Download the Shepherd Manual Pack
  2. Extract the zip
  3. Put the ROOT.war in your tomcat server's webapp directory
  4. Ensure the tomcat user can write files to $CATALINA_HOME/conf (Used for DB Setup Wizard)
  5. Restart Tomcat
  6. Open your Tomcat Server in your browser (Default Insecure Tomcat Running Locally: http://127.0.0.1:8080)
  7. You will be brought to the Shepherd Setup Wizard. Enter your Database and Database User details here
  8. Ensure you have selected the "Fresh Database" override option and click submit
  9. Sign in with the default admin / password credentials and then update the password in the following prompt.
  10. You're Done!

Clone this wiki locally