Skip to content
CemililkimPublic

About

Read-only infrastructure explorer for JetBrains IDEs. Discover Docker, Compose, Caddy, systemd, ports, networks, mounts and routing on a Linux VPS over SSH, with local snapshots and change history.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VPS Graph

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.

What it does

  • 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

Why VPS Graph

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.

IDE compatibility

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.

Requirements

  • 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_hosts file
  • 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.

Quick start

  1. Install VPS Graph from the JetBrains Marketplace or from the plugin ZIP.
  2. Open the VPS Graph Tool Window.
  3. Enter the host, port, username, and private-key path.
  4. Select Scan server.

Read Getting started before connecting to a VPS.

Server helper

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.

Recommended SSH user setup

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.

Screenshots

Final public screenshots use sanitized example infrastructure. The required views and privacy checks are documented in marketplace/SCREENSHOTS.md.

Current limitations

  • 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

Development

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.

Contributing

See CONTRIBUTING.md.

Security reports must follow SECURITY.md.

Privacy

See PRIVACY.md for the local data boundary.

License

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.

About

Read-only infrastructure explorer for JetBrains IDEs. Discover Docker, Compose, Caddy, systemd, ports, networks, mounts and routing on a Linux VPS over SSH, with local snapshots and change history.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages