VPS Graph is a local-first, read-only infrastructure explorer for JetBrains IDEs. It connects to a Linux VPS over SSH and helps you understand what is running and how the infrastructure pieces connect.
VPS Graph has been tested on IntelliJ IDEA, PyCharm, WebStorm, GoLand, and Rider.
Source: github.com/cemililkim/vps-graph
Screenshot preview: final sanitized Marketplace screenshots are listed in the release screenshot manifest.
- explores Docker and Compose applications
- maps Caddy domains, routes, and upstreams
- shows sanitized Systemd services and host listeners
- relates containers, ports, networks, mounts, services, and routes
- records local infrastructure snapshots and evidence-qualified Changes history
VPS Graph connects directly from your JetBrains IDE to the selected VPS.
It has no account, backend, telemetry, analytics, cloud sync, or remote-management controls. Scans are manual, SSH commands are fixed and read-only, and the optional privileged helper returns only strictly allowlisted metadata.
The goal is not to become another server management panel. VPS Graph is designed to help you inspect and understand infrastructure without changing it.
VPS Graph is distributed as a single plugin for compatible JetBrains IDEs.
It has currently been manually tested on:
- IntelliJ IDEA
- PyCharm
- WebStorm
- GoLand
- Rider
Marketplace compatibility with an IDE does not necessarily mean that every JetBrains product has been manually tested.
If you successfully use VPS Graph on another JetBrains IDE, feedback is welcome.
- a compatible JetBrains IDE
- a Debian or Ubuntu-focused Linux VPS reachable over SSH
- public-key authentication and a locally readable private-key file
- the verified VPS host key in the local OpenSSH
known_hostsfile - optional reviewed server helper for Docker, Compose, Caddy, Systemd, and listener discovery
SSH passwords, agents, passphrase UX, OpenSSH config parsing, ProxyJump, and bastion hosts are not supported in the 0.1.x line.
- Install VPS Graph from the JetBrains Marketplace or from the plugin ZIP.
- Open the VPS Graph Tool Window.
- Enter the host, port, username, and private-key path.
- Select Scan server.
Read Getting started before connecting to a VPS.
Basic host discovery does not need elevated access.
Deeper Docker, Compose, Caddy, Systemd, and listener discovery requires the optional server helper.
It exists because direct Docker socket access is effectively privileged. The helper is transparent Python standard-library source, accepts no runtime arguments, and is granted only one exact sudo command.
Review the source before copying it to a VPS. VPS Graph does not install it automatically and does not recommend curl | sudo installation.
See the security model for the complete boundary.
VPS Graph does not require a dedicated SSH username, but using a separate, unprivileged account such as vpsgraph is recommended for better privilege isolation.
An existing SSH account is also supported.
The optional server helper does not create users, add them to the docker group, or grant unrestricted sudo access. It only grants the selected SSH user permission to run the exact, argument-free VPS Graph inspection helper.
See server-helper/README.md for the complete setup and security model.
Final public screenshots use sanitized example infrastructure. The required views and privacy checks are documented in marketplace/SCREENSHOTS.md.
- one active server at a time
- manual scans, not continuous monitoring
- Debian and Ubuntu-focused discovery
- no SSH password, agent, passphrase, ProxyJump, or bastion support
- no remote terminal, service management, container management, or infrastructure writes
- discovery is intentionally allowlisted, not complete host inventory
- not every compatible JetBrains IDE has been manually tested
Requirements: JDK 21, Node.js with npm, and Python 3.
npm --prefix graph-ui ci
npm --prefix graph-ui test
npm --prefix graph-ui run build
./gradlew :scanner-core:test
./gradlew :intellij-plugin:test
./gradlew :intellij-plugin:buildPlugin
./gradlew :intellij-plugin:verifyPlugin
python -m unittest discover -s server-helper/tests -v
Use gradlew.bat on Windows.
./gradlew releaseArtifacts produces the plugin ZIP plus a deterministic helper archive and SHA-256 integrity checksum.
See CONTRIBUTING.md.
Security reports must follow SECURITY.md.
See PRIVACY.md for the local data boundary.
VPS Graph is released under the Apache License 2.0.
Publisher and copyright holder: Cemil İlkim Teke.
Third-party license details are in THIRD_PARTY_NOTICES.md.