Installation Guide

DISCLAIMER

IMPORTANT: This tool is for educational purposes and authorized testing only.
Use only on systems you own or have explicit permission to test.

Quick Installation

Prerequisites

Ubuntu/Debian Linux system
sudo privileges
Internet connection

One-Command Setup

Clone the repository and run the automated setup script:

# Clone and setup everything automatically
git clone https://github.com/MetaMops/Phisher-man-react.git
cd Phisher-man-react
chmod +x start.sh
./start.sh
sudo node server.js

Access: http://localhost:5000

Manual Installation

Step 1: Install Dependencies

Update your system and install Node.js and Apache2:

# Update system
sudo apt update && sudo apt upgrade -y

# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install Apache2
sudo apt install apache2 -y

# Enable Apache2
sudo systemctl enable apache2
sudo systemctl start apache2

Step 2: Clone and Setup

Clone the repository and install Node.js dependencies:

# Clone repository
git clone https://github.com/MetaMops/Phisher-man-react.git
cd Phisher-man-react

# Install Node.js dependencies
npm install

Step 3: Start Application

Start the application with sudo privileges (required for Apache management):

# Start with sudo (required for Apache management)
sudo node server.js

Step 4: Access Dashboard

Open your browser and navigate to the local server:

http://localhost:5000

Verification

Check if everything is installed correctly:

# Check Apache Status
sudo systemctl status apache2

# Check Node.js Version
node --version
npm --version

Test Dashboard

Open http://localhost:5000
Click "Start Apache Service"
Deploy a template
Check logs

Troubleshooting Installation

Node.js Issues

If Node.js installation fails, try these solutions:

# Reinstall Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Check installation
node --version
npm --version

Apache Issues

If Apache installation fails, try these solutions:

# Reinstall Apache
sudo apt remove apache2
sudo apt install apache2

# Check configuration
sudo apache2ctl configtest

# Restart service
sudo systemctl restart apache2

Permission Issues

If you encounter permission errors, try these solutions:

# Fix Apache permissions
sudo chown -R www-data:www-data /var/www/html/
sudo chmod -R 755 /var/www/html/

# Check sudo access
sudo whoami

Port Conflicts

If ports are already in use, try these solutions:

# Check port 5000
sudo lsof -i :5000

# Check port 80 (Apache)
sudo lsof -i :80

# Kill conflicting processes
sudo kill -9 PID

Advanced Configuration

Custom Port

Edit server.js to change the default port:

const PORT = process.env.PORT || 8080; // Change from 5000

Custom Apache Document Root

Edit /etc/apache2/sites-available/000-default.conf:

DocumentRoot /custom/path/html

SSL/HTTPS Setup

Set up SSL certificates for secure connections:

# Install SSL certificate
sudo apt install certbot python3-certbot-apache

# Get certificate
sudo certbot --apache -d yourdomain.com

Uninstallation

To completely remove Phisher-Man React Edition:

# Stop services
sudo systemctl stop apache2
sudo pkill -f "node server.js"

# Remove application
cd ..
rm -rf Phisher-man-react

# Remove Apache (optional)
sudo apt remove apache2
sudo apt autoremove

Need help? Join our Discord: https://discord.gg/KcuMUUAP5T