Nexus VPS - Comprehensive Pentesting & Automation Installer

A powerful interactive bash script for automating penetration testing, workflow automation, and AI assistant deployment

Features • Installation • Tools • Documentation • Support

📌 Overview

Quick Links: ⭐ Star on GitHub | 📥 Download Latest | 🐛 Report Issue | 📖 Wiki

Nexus VPS is an all-in-one automation script designed for cybersecurity professionals, developers, and tech enthusiasts. It streamlines the setup of a complete penetration testing environment, workflow automation platform, and AI-powered assistants on Ubuntu systems.

Key Capabilities

🔐 Penetration Testing Suite - Automated installation of industry-standard security tools
🤖 AI Assistants - Dockerized cybersecurity and programming AI with Ollama
⚙️ Workflow Automation - n8n platform with PM2 process management
🖥️ GUI Environments - GNOME/XFCE desktops with remote access support
📊 System Intelligence - Comprehensive hardware and network diagnostics

System Requirements

OS: Ubuntu 22.04 LTS (primary), Ubuntu 20.04+ (compatible)
RAM: 4GB minimum (8GB+ recommended for AI assistants)
Storage: 20GB+ free space
Network: Internet connection for downloads
Privileges: Root/sudo access required

✨ Features

🎯 Core Features

Interactive Menu System with intuitive navigation
Batch Installation for all tools at once
Dependency Auto-Resolution (Ruby/RVM, Go, Node.js/NVM, Docker)
Version Verification for all installed tools
One-Click Reinstall with complete cleanup

🚀 Advanced Features

Dockerized AI Stack with Ollama backend
PM2-Managed n8n with auto-start on boot
Remote Desktop Support via xRDP
System Diagnostics with speedtest & hardware info
Modular Architecture for easy customization

🛠 Tools & Services

Security & Penetration Testing

Tool	Category	Description
Metasploit	Exploitation Framework	Complete penetration testing platform
Nmap	Network Scanner	Port scanning and network discovery
Hydra	Password Cracker	Network logon cracker
SQLMap	Web Security	Automatic SQL injection tool
BeEF-XSS	Browser Exploitation	Cross-site scripting framework
Nikto	Web Scanner	Web server vulnerability scanner
Recon-ng	Reconnaissance	Web reconnaissance framework
ffuf	Web Fuzzer	Fast web fuzzer
Wfuzz	Web Fuzzer	Web application security fuzzer
ProxyChains	Network Tool	Proxy chains for anonymity

Development & Infrastructure

Category	Tools
Containers	Docker, Docker Compose
Web Server	Nginx
Editor	Neovim (modern Vim)
Languages	Go, Ruby (via RVM), Node.js (via NVM)
Process Manager	PM2 (for n8n)

Automation & AI

Service	Purpose	Access
n8n	Workflow Automation	`http://<server-ip>:5678`
Lily AI	Cybersecurity Assistant	`lily "your query"`
Coder AI	Programming Assistant	`coder "your query"`
Ollama	AI Model Backend	Docker container

GUI & Remote Access

GNOME - Full-featured Ubuntu Desktop environment
XFCE - Lightweight Xubuntu Desktop environment
xRDP - Remote Desktop Protocol server for Windows clients

System Information

Speedtest CLI - Network speed testing
inxi - System information tool
lshw - Hardware lister

📥 Quick Start

Installation

# Clone the repository
git clone https://github.com/nexus-arm/Nexus-VPS.git
cd Nexus-VPS

# Make the script executable
chmod +x nexus-vps.sh

# Run with sudo privileges
sudo ./nexus-vps.sh

First Launch

Upon execution, you'll see the interactive main menu:

================================================================
                          MAIN MENU
================================================================
1) Install Pentest Tools (Manual/All)
2) Install Graphical Environment (GUI)
3) Install AI Assistants (Lily/Coder)
4) Manage n8n (Automation Workflow)
5) Check Tool Versions
6) Re-install All Pentest Tools
7) System & Network Information
0) Exit
================================================================
Please enter your choice:

🔍 Menu Details

1️⃣ Pentest Tools Installation

Choose between individual tool installation or bulk deployment:

Individual Installation

Select specific tools from the comprehensive list
Installs dependencies automatically
Skips already-installed tools

Bulk Installation (Install All)

One-command deployment of all security tools
Automated dependency resolution
Progress indicators for each tool

Available Tools: SQLMap, Hydra, Nmap, BeEF-XSS, ffuf, Docker, Neovim, Wfuzz, Metasploit, Nikto, Recon-ng, Nginx, ProxyChains

2️⃣ Graphical Environment (GUI)

Transform your VPS into a full desktop environment:

GNOME Desktop

Complete Ubuntu desktop experience
Modern interface with extensive features
Resource: ~2GB RAM minimum

XFCE Desktop

Lightweight alternative to GNOME
Ideal for low-resource VPS
Resource: ~1GB RAM minimum

xRDP Remote Access

Enable Windows Remote Desktop connections
Automatic configuration
Default port: 3389

Post-Installation

⚠️ Important: Reboot required after GUI installation

sudo reboot

Connection: Use Windows Remote Desktop or Remmina to connect to <server-ip>:3389

3️⃣ AI Assistants (Lily & Coder)

Deploy AI-powered assistants in isolated Docker containers:

Lily - Cybersecurity AI

Model Options: Q4 (faster) or Q5 (more accurate)
Specialization: Vulnerability analysis, exploit research, security best practices
Use Cases:
- Threat intelligence queries
- CVE explanations
- Security tool guidance

Example Usage:

lily "Explain the OWASP Top 10 vulnerabilities"
lily "How does a SQL injection attack work?"
lily "Best practices for securing SSH"

Coder - Programming AI

Model: Qwen2-7B (optimized for code)
Specialization: Code generation, debugging, algorithm design
Use Cases:
- Script automation
- Code review
- Programming tutorials

Example Usage:

coder "Write a Python port scanner"
coder "Debug this bash script: [paste code]"
coder "Explain asyncio in Python"

Architecture

Backend: Ollama running in shared Docker container
Persistence: Models stored in Docker volumes
Performance: GPU acceleration if available, CPU fallback

4️⃣ n8n Workflow Automation

Manage your n8n instance with PM2 process management:

Features

Install: Fresh n8n deployment with PM2
Update: Pull latest n8n version
Control: Start, stop, restart, status checks
Auto-Start: Configured to launch on system boot
Web Interface: http://<server-ip>:5678

Management Commands

# Via script menu (recommended)
Select option 4 from main menu

# Direct PM2 commands
pm2 list                 # View all processes
pm2 logs n8n            # View n8n logs
pm2 restart n8n         # Restart n8n
pm2 stop n8n            # Stop n8n

Use Cases

Webhook automation
Data integration pipelines
Scheduled task execution
API orchestration

5️⃣ Check Tool Versions

Quick verification of installed tools and their versions:

Output Example:

Docker: 24.0.5
Nmap: 7.94
Metasploit: 6.3.15
Python3: 3.10.12
Node.js: v20.11.0
Go: 1.21.5

6️⃣ Re-install All Tools

Complete system refresh:

Removes all installed tools cleanly
Reinstalls from scratch
Useful for:
- Fixing corrupted installations
- Updating to latest versions
- Starting fresh after experiments

⚠️ Warning: This will remove existing configurations and data

7️⃣ System & Network Information

Comprehensive diagnostics suite:

Speedtest

Internet connection speed (up/down)
Latency measurements
ISP information

Hardware Summary (inxi)

CPU, RAM, storage overview
Operating system details
Kernel version

Detailed Hardware (lshw)

Complete hardware inventory
Device drivers
System architecture

⚙️ Advanced Configuration

Environment Variables

Tools like RVM and NVM modify shell configurations. Ensure your shell profile is sourced:

# For bash users
source ~/.bashrc

# For zsh users
source ~/.zshrc

Docker Post-Install

Add user to docker group to avoid sudo:

sudo usermod -aG docker $USER
newgrp docker

Firewall Configuration

If using UFW, allow necessary ports:

sudo ufw allow 5678/tcp   # n8n
sudo ufw allow 3389/tcp   # xRDP
sudo ufw reload

Custom Tool Paths

Tools are installed in standard locations:

System tools: /usr/bin, /usr/local/bin
RVM: ~/.rvm
NVM: ~/.nvm
Go: /usr/local/go

⚡ Troubleshooting

Common Issues & Solutions

"Command not found" after installation

Cause: Shell environment not refreshed
Solution:

# Reload shell configuration
source ~/.bashrc  # or ~/.zshrc

# Or start a new terminal session
exit
# Login again

RVM/NVM errors

Cause: Environment not properly sourced
Solution:

# Check if RVM is in PATH
echo $PATH | grep rvm

# Manually source RVM
source ~/.rvm/scripts/rvm

# Check if NVM is loaded
command -v nvm

# Manually source NVM
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Docker permission errors

Cause: User not in docker group
Solution:

# Add user to docker group
sudo usermod -aG docker $USER

# Apply group changes (logout/login alternative)
newgrp docker

# Verify
docker ps

n8n won't start

Cause: Port 5678 already in use
Solution:

# Check what's using the port
sudo lsof -i :5678

# Kill the process or change n8n port
pm2 stop n8n
# Edit n8n configuration to use different port

Remote GUI (xRDP) not working

Cause: Service not running or firewall blocking
Solution:

# Check xRDP status
sudo systemctl status xrdp

# Restart xRDP
sudo systemctl restart xrdp

# Check firewall
sudo ufw status
sudo ufw allow 3389/tcp

AI assistants not responding

Cause: Ollama container not running or out of memory
Solution:

# Check Docker containers
docker ps

# Check Ollama logs
docker logs ollama

# Restart Ollama container
docker restart ollama

# Check available memory
free -h

Metasploit database errors

Cause: PostgreSQL not initialized
Solution:

# Initialize Metasploit database
msfdb init

# Or reinitialize
msfdb reinit

Getting Help

Check logs: Most tools have detailed logs in /var/log/ or ~/.pm2/logs/
Verbose mode: Run tools with -v or --verbose flags
GitHub Issues: Report bugs at github.com/nexus-arm/Nexus-VPS/issues
Community: Join discussions in the repository

🛡️ Security Considerations

Best Practices

Firewall: Configure UFW to restrict unnecessary ports
SSH: Disable password authentication, use key-based auth only
Updates: Regularly update all tools and the system
Isolation: Use Docker for potentially risky tools
Monitoring: Enable system logging and monitoring

Responsible Use

⚠️ Important: This toolkit is designed for:

Authorized penetration testing
Security research in controlled environments
Educational purposes with proper lab setup
Professional security assessments with written permission

Unauthorized use of these tools against systems you don't own or have explicit permission to test is illegal and unethical.

🤝 Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

🐛 Bug Reports: Open an issue with detailed reproduction steps
✨ Feature Requests: Suggest new tools or improvements
📝 Documentation: Improve README or add guides
💻 Code: Submit pull requests with enhancements

Contribution Guidelines

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Development Setup

# Clone your fork
git clone https://github.com/nexus-arm/Nexus-VPS.git
cd Nexus-VPS

# Create a test branch
git checkout -b test-feature

# Make changes and test
sudo ./nexus-vps.sh

# Test in a clean environment (recommended)
# Use a VM or Docker container

📜 License

This project is licensed under the MIT License - see the LICENSE file for full details.

MIT License Summary

✅ Commercial use
✅ Modification
✅ Distribution
✅ Private use

❗ License and copyright notice must be included
❗ Software is provided "as is" without warranty

🌟 Acknowledgments

Built With

Bash - Shell scripting
Docker - Containerization
Ollama - AI model serving
n8n - Workflow automation
PM2 - Process management

Special Thanks

The open-source security community
Contributors to all integrated tools
Ubuntu and Debian maintainers
Everyone who has starred or contributed to this project

💬 Support

Get Help

📖 Documentation: You're reading it! Check the sections above
🐛 Bug Reports: GitHub Issues

Connect

GitHub: nexus-arm
Project: Nexus-VPS

☕ Support the Project

If you find Nexus VPS useful and would like to support continued development, donations are greatly appreciated!

Donate via TON Blockchain:

UQBnoOaSb46CRspYXK_ha9tiD5yum-ZYUGAnhJCX5Urfffg9

Your support helps:

🔧 Maintain and update tools
📚 Improve documentation
✨ Add new features
🐛 Fix bugs faster

📊 Project Stats

Made with ❤️ for the cybersecurity community

📝 Changelog

Version 3.0 (Current)

✨ Added AI assistants (Lily & Coder)
🔧 Improved menu navigation
📦 Enhanced dependency management
🐛 Bug fixes and stability improvements

⭐ Star this repo if you find it useful! ⭐

🏠 View on GitHub

Report Bug • Request Feature •

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
Banner.jpg		Banner.jpg
LICENSE		LICENSE
README.md		README.md
nexus-vps.sh		nexus-vps.sh

Folders and files

Latest commit

History

Repository files navigation