Skip to main content

⚡ 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.js and /dev/pts pseudo-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)
  • 🗂️ Process Explorer: Live running processes list sorted by CPU% or Memory% with instant SIGTERM / SIGKILL signals.
  • 🔒 Enterprise-Grade Security: PBKDF2-HMAC-SHA256 password hashing, secure session tokens, rate-limited login defense, and strict permission enforcement (0600 on credentials).
  • 📦 Offline-Ready & Zero CDN Dependency: xterm.js and 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)

Source distribution for vpspilot 1.0.0
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)

Table of built distributions (wheels) for vpspilot 1.0.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page