⚡ VPSPilot: Precision VPS Management Deck & Web Command Center
VPSPilot is an autonomous, production-grade Python package and web dashboard engineered specifically for Linux Virtual Private Servers (VPS). It equips VPS owners and sysadmins with an online command center for host configuration, real-time hardware telemetry, full-duplex interactive web terminal, and complete systemd service management.
🌟 Key Capabilities
- 📊 Real-Time Telemetry: Live per-core CPU utilization, RAM usage, swap space, mounted filesystem quotas, and live RX/TX network transfer rates.
- 💻 Interactive Web Terminal: Full-featured web shell powered by
xterm.jsand/dev/ptspseudo-terminals with resize detection (TIOCSWINSZ), ANSI colors, and shortcut toolbar (Ctrl+C, Ctrl+D, Clear, Reconnect). - ⚙️ All Services Manager: Real-time listing of all systemd units with state filters (
active,inactive,failed), one-click controls (Start, Stop, Restart), and an integrated Journalctl log inspector modal. - 🛠️ VPS Configuration Deck:
- Hostname changer (
hostnamectl) - Timezone selector (
timedatectl) - DNS resolvers viewer (
/etc/resolv.conf) - SSH daemon security inspection (Port, Root Login, Password Auth)
- Firewall manager (UFW rules: Allow/Deny, rule removal, enable/disable toggle)
- System maintenance (package update status, cache cleanup, safe Reboot/Poweroff)
- Hostname changer (
- 🗂️ Process Explorer: Live running processes list sorted by CPU% or Memory% with instant
SIGTERM/SIGKILLsignals. - 🔒 Enterprise-Grade Security: PBKDF2-HMAC-SHA256 password hashing, secure session tokens, rate-limited login defense, and strict permission enforcement (
0600on credentials). - 📦 Offline-Ready & Zero CDN Dependency:
xterm.jsand vendor assets are bundled inside the Python package, ensuring the terminal functions flawlessly on isolated or restricted networks.
🚀 Installation
Global Install via pip
pip install --break-system-packages .
Or install in development/editable mode:
pip install --break-system-packages -e .
🖥️ Command Line Usage
Once installed, the global vpspilot executable is available anywhere:
# Start VPSPilot in foreground
vpspilot start --port 8888
# Start VPSPilot as a background daemon
vpspilot start --port 8888 --daemon
# Check daemon status
vpspilot status
# Stop daemon
vpspilot stop
# Restart daemon
vpspilot restart
# Change admin password
vpspilot set-password
# View current configuration
vpspilot config show
# Install as an automated systemd service (boots on server start)
sudo vpspilot install-service
# Uninstall systemd service
sudo vpspilot uninstall-service
🌐 Web Dashboard Access
After launching, open your browser and navigate to:
http://<YOUR-VPS-IP>:8888
On first launch, an initial administrative password is automatically generated and printed to the terminal console if one has not been specified.
🏗️ Architecture
Client Browser (SPA)
│
├── REST API (/api/*) ──> aiohttp Web Server
├── Telemetry WS (/ws/metrics) ──> psutil + /proc Kernel Telemetry
└── Web Terminal WS (/ws/terminal) ──> Python PTY Bridge (pty.openpty)
│
└── /dev/pts (bash/zsh login shell)
📄 License
Apache-2.0 / MIT. Crafted with precision for Linux VPS systems.
Metadata
Release files for vpspilot 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vpspilot-1.0.0.tar.gz | 106.6 kB | Without provenance | Details for vpspilot-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| vpspilot-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for vpspilot-1.0.0-py3-none-any.whl |
Total release size: 215.0 kB
Release files / vpspilot-1.0.0.tar.gz
| Download URL | vpspilot-1.0.0.tar.gz |
|---|---|
| Size | 106.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3c541a1c3f45e3cb1b89418196dc4e4642f042d7d9c4df81a5732340518bcfc9
|
|
BLAKE2b-256 checksum How to use checksums |
98290c602b56ce19cabd8c6e488a799d9a5d1072faa41e1051ab4adef88b50ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / vpspilot-1.0.0-py3-none-any.whl
| Download URL | vpspilot-1.0.0-py3-none-any.whl |
|---|---|
| Size | 108.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
545ed4932bf7765880a35e6d0fb03a059782f46fe9f41e78177cd5bcde5a7e67
|
|
BLAKE2b-256 checksum How to use checksums |
79f688382bcd9929d8afbe9fbe99a3e4420adbd8e96dbdd9ec6bff58d38ebfd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for vpspilot 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.