Installation

Installing ODIN

ODIN requires Python 3. Using pipenv for managing the required libraries is the best option to avoid Python installations getting mixed-up. Do this:

1. Run: pip3 install --user pipenv or python3 -m pip install --user pipenv
2. Run: git clone https://github.com/chrismaddalena/ODIN.git
3. Run: cd ODIN && pipenv install
4. Start using ODIN by running: pipenv shell

Optional: Install PhantomJS -- brew install phantomjs or apt install phantomjs

This may go away soon due to PhantomJS no longer being actively supported and developed with Selenium.

Note 1: On macOS you may get an error about pew not being in your PATH after installing pipenv and attempting to install ODIN. To fix it, follow these steps in order:

• Uninstall virtualenv, pipenv, and pew.
• Install virtualenv
• Install pew
• Install pipenv

Note 2: If you're running as root on something like Kali Linux, you'll want to drop the --user portion of the pip commands above. That seems to create issues for actually using pipenv commands later, at least on Kali.

Setup API Keys

1. Review the keys.config.sample file and use it as a template to create a keys.config file.
2. Run setup_check.py in the /setup directory to make sure your keys.config file is in order.
3. Install awscli, run aws configure, and follow the prompts to enter your credentials.