Home > NUKM > Package Guide

ReclaimNUKM Package Structure & Usage Guide

NUKM Definition: NUKM is defined by the acronym for 'Next Unit of Kill Module' as it pertains to data sanitization.

Complete package contents, installation guide, and usage instructions for ReclaimNUKM distribution.

🚀 Quick Start for End Users

Extract the Package: tar -xzf ReclaimNUKM-v1.5.tar.gz
Run Installation: ./install.sh
Launch Application: ./ReclaimNUKM

📦 Package Contents

Your ReclaimNUKM package is now complete and ready for distribution. Here's what it contains:

Core Application Files

ReclaimNUKM - Main executable (~18.6MB standalone binary)
zapper_ts.2.py - Source code for the application
requirements.txt - Python dependencies

Documentation

README.md - Comprehensive setup and usage guide
ReclaimNUKM_Documentation.html - Complete user manual
WIPE_METHODS_DOCUMENTATION.md - Detailed wipe method explanations
SUDO_CONFIGURATION.md - Privilege setup instructions
DESKTOP_INTEGRATION.md - Desktop menu integration guide
ReclaimNUKM_Help.html - Built-in application help
ReclaimNUKM_Help.txt - Text-based help reference

Configuration & Setup Scripts

install.sh - Automated installation script
setup-sudoers.sh - Sudo privilege configuration
setup_desktop.sh - Desktop integration setup
reclaimzapper-sudoers - Sudoers configuration template
ReclaimNUKM.desktop - Desktop menu entry file

Assets & Resources

/wp-content/uploads/nukm/ - Application icons and images
embedded_logo.b64 - Base64 encoded logo

Build & Development Files

build.sh - Build script for creating executables
ReclaimNUKM.spec - PyInstaller specification file
build/ - Build artifacts directory
dist/ - Distribution files directory

Testing & Logs

logs/ - Application operation logs
wipe_results/ - Wipe operation results and reports
test_*.py - Test scripts for various components

📋 System Requirements

Minimum Requirements

Component	Requirement	Notes
Operating System	Ubuntu 22.04 LTS or later	Other Debian-based distributions supported
Python	3.8 or higher	Automatically installed by install.sh
RAM	4GB minimum	More recommended for large drives
Storage	100MB free space	For application and logs
Privileges	Administrative access (sudo)	Required for disk operations
Enterprise Support	sg3-utils package	NEW for enterprise drive support

Supported Platforms

✅

Ubuntu 22.04 LTS
Optimized

✅

Ubuntu 20.04 LTS
Supported

✅

Debian-based
Compatible

🔧 Installation Process

The install.sh script automatically:

Updates package lists
Installs system dependencies (Python, Tkinter, GNU tools, etc.)
Installs Python packages (Pillow, pyudev, ttkbootstrap)
Configures sudo privileges
Sets up desktop integration

📖 Documentation Access

For End Users

Quick Start: Open README.md in any text editor
Complete Manual: Open ReclaimNUKM_Documentation.html in web browser
Built-in Help: Click "Help" button in the application

For System Administrators

SUDO_CONFIGURATION.md - Detailed privilege setup
WIPE_METHODS_DOCUMENTATION.md - Technical wipe method details
DESKTOP_INTEGRATION.md - Desktop deployment guide

📊 Wipe Methods Overview

Method	Speed	Security Level	Best For
Quick Format	⚡ Fast	🔒 Basic	General cleanup
Zero Device	🐌 Slow	🔒🔒 High	Personal data
Shred (3 Pass)	🐌🐌 Very Slow	🔒🔒🔒 Military	Classified information

🛠️ Troubleshooting

Common Installation Issues

"Permission denied" during installation

# Ensure you're not running as root
whoami # Should show your username, not root

Missing dependencies

sudo apt update
sudo apt install python3 python3-pip python3-tk

Sudo configuration fails

# Check sudoers file
sudo visudo -f /etc/sudoers.d/reclaimzapper

Application Issues

Application won't start

# Check Python installation
python3 --version
# Check dependencies
pip3 list | grep -E "(Pillow|pyudev|ttkbootstrap)"

Device not detected

# Check device permissions
lsblk -o NAME,SIZE,TYPE,MOUNTPOINT
# Ensure device is not mounted

🔒 Security Notes

The application requires sudo access for disk operations
Sudo configuration is restricted to specific commands only
All operations are logged for audit purposes
Device validation prevents accidental data loss

📝 File Locations After Installation

/usr/local/bin/ReclaimNUKM -> ~/Desktop/ReclaimNUKM/ReclaimNUKM
/etc/sudoers.d/reclaimzapper
~/.local/share/applications/ReclaimNUKM.desktop
~/Desktop/ReclaimNUKM/ (complete package)

🔄 Updating the Application

To update to a newer version:

Download the new package
Extract to a new directory
Run the new install.sh script
The old version will be replaced automatically

📞 Support Information

For technical support:

Check the documentation files
Review the troubleshooting section
Check application logs in logs/ directory
Verify system requirements are met

⚠️ Important Warnings

Always backup data before wiping any device
Verify device selection carefully in the application
Monitor operations for errors or warnings
Keep logs for audit and troubleshooting purposes

Package Information

Version: 1.5.0 | Platform: Ubuntu 22.04 LTS (Intel optimized)

Package created on: Current Date | Size: ~18.6MB executable