Installation Guide

Installation Guide

All commands assume Debian/Ubuntu. You can adjust for your distro as needed.

1. System level Packages

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git curl build-essential \
  libssl-dev libffi-dev

2. Install Security Tools

# Discovery & Scanning
sudo apt install -y nmap masscan zmap amass subfinder

# Web testing
sudo apt install -y gobuster ffuf feroxbuster nikto whatweb sqlmap

# Vulnerability scanning
go install -v github.com/projectdiscovery/nuclei/v2/cmd/nuclei@latest
sudo apt install -y trivy testssl.sh

(Full list in Security Tools Reference page.)

3. Clone Repository

git clone https://github.com/Slayingripper/OctapusPrime.git
cd OctapusPrime

4. Python Virtual Environment

python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

5. Systemd Services (Production)

sudo cp systemd/octapus-*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable octapus-controller octapus-web
sudo systemctl start  octapus-controller octapus-web

6. Direct Run (Development)

source venv/bin/activate
python3 bin/webapp/server.py            # Web UI on http://localhost:8080
python3 bin/octapus_controller.py       # (optional) GPIO controller