RANGER SERIES
ProxMoxRanger
Modern Hot-Swap Storage Manager for Proxmox VE
Easily expose and access node-local block storage via SMB without spinning up a VM. ProxMoxRanger provides a secure, web-based interface for managing hot-swappable storage devices in your Proxmox environment.
What is ProxMoxRanger?
ProxMoxRanger is a web-based management interface designed for handling hot-swappable storage devices in Proxmox VE environments. It eliminates the need to spin up VMs for accessing node-local block storage via SMB, providing a streamlined, efficient solution for storage management.
Application Interface
ProxMoxRanger web interface showing device management and SMB share controls
Core Features
Storage Management
- Automatic USB & SATA device detection
- One-click mount/unmount with safety checks
- Safe hot-swap capabilities
- Real-time device status tracking
Network Sharing
- Instant SMB/CIFS share creation
- Samba integration for cross-platform access
- Windows/Mac/Linux compatibility
- Automatic permission configuration
User Management
- View all Samba users and access rights
- Add/remove users with ease
- Automatic permission updates
- Proxmox host authentication integration
Security & Interface
- PAM authentication (system credentials)
- IP whitelist protection
- 12-hour session timeout
- Professional dark-themed UI
- System logs with syntax highlighting
System Requirements
- ✓ Proxmox VE 7.0 or higher
- ✓ Python 3.7+
- ✓ Samba (for network shares)
- ✓ Root or sudo access
- ✓ Port 8010 accessibility (configurable)
Quick Installation
One-command installation that automatically handles all dependencies:
curl -fsSL https://raw.githubusercontent.com/peterjohannmedina/ProxMoxRanger/main/install.sh | bash
The installer automatically configures Python packages, systemd service setup, and Samba integration.
Access & Usage
Access URL: http://YOUR_PROXMOX_IP:8010
Login Credentials: Your Proxmox host credentials (root username and password)
Typical Workflow:
- View connected devices in the dashboard
- Mount unmounted devices with one click
- Create SMB shares for mounted storage
- Manage user permissions through the interface
- Monitor logs and operations in real-time
Security Features
Authentication
- PAM authentication (system credentials)
- Session-based security
- No hardcoded credentials
Network Protection
- Configurable IP whitelist
- Private network defaults
- Firewall rule recommendations
What's Included
- webui.py - Flask web application for management interface
- hotswap-manager.sh - Backend device operations handler
- install.sh - Automated installation and configuration
- systemd service - Auto-start and management integration
Why ProxMoxRanger?
- No VM overhead - Direct node-local access without spinning up VMs
- Fast operations - One-click mount/unmount with instant SMB sharing
- Modern UI - Professional dark-themed, fully responsive interface
- Enterprise security - PAM authentication with IP whitelisting
- Real-time monitoring - Live device status and system logs
- Easy management - Intuitive interface for all storage operations
