Skip to content

Setting up Katana

Jump to bottom
Alex edited this page May 13, 2023 · 7 revisions

Katana is a Java application, distributed as a fat jar. Grab the latest release here.

Prerequisites

You will need

  • Java 11

  • SUDO privileges, if running on *nix.
    NOTE: You can use IPTables to redirect all port 80 traffic to an unprivileged port number if you do not wish to run Katana as root.

    Here's an example which allows you to run Katana on port 8200 but still receive traffic on port 80. 
    sudo iptables -I INPUT -j ACCEPT
sudo iptables -t nat -A PREROUTING -p tcp -m tcp -i en0 --dport 80 -j REDIRECT --to-ports 8200

    Make sure to change en0 to your network adapter device.

  • A text editor, Notepad++ and VSCode are good options, but anything which lets you edit .json files will do.

Setup

Create a file called start.sh (for *nix) or start.bat (for Windows) and put java -Xms1M -jar Katana.jar. Put Katana.jar in the same folder as the newly created start script. Run the script and voilà, you've successfully run Katana!

NOTE: *nix users will first have to run chmod +x start.sh on the script to make it double-clickable.

Next

Head to Configuring Katana to get Katana fully setup.

Clone this wiki locally