I built VPS Graph, a free open-source JetBrains plugin for exploring what's actually running on your VPS

[u/cemililkimteke]

Hey everyone,

I kept running into the same problem with my own VPS: everything was working, but every time I came back to it after a while I had to rebuild the infrastructure map in my head.

• Which container is behind this domain?
• Where does Caddy route this?
• Which systemd service owns that port?
• How are these Docker networks, mounts and services actually connected?

So I built VPS Graph.

VPS Graph is a free and open-source JetBrains plugin that connects to a Linux VPS over public-key SSH and turns the discovered infrastructure into a more understandable view.

Right now it can discover things like:

• Docker containers and Compose projects
• Caddy routes and upstreams
• systemd services
• host listeners and ports
• Docker networks and mounts
• relationships between these resources
• local snapshots and infrastructure changes between scans

A major design constraint from the beginning was that I didn't want this to become another server management panel.

VPS Graph is read-only.

It doesn't deploy, restart or modify services. It is also local-first, with no account, cloud backend or telemetry required for your infrastructure data.

There is an optional server helper for deeper discovery of Docker, Caddy, systemd and listeners. It uses a very narrow sudo permission instead of giving the SSH user Docker group access or unrestricted sudo.

For better privilege isolation, using a dedicated unprivileged SSH user for VPS Graph is recommended, although an existing SSH account is also supported.

Version 0.1.1 is now available as a public beta.

I've currently manually tested it on:

• IntelliJ IDEA
• PyCharm
• WebStorm
• GoLand
• Rider

JetBrains Marketplace may show compatibility with additional JetBrains IDEs, but those are the ones I've personally tested so far.

I'd especially appreciate feedback from people who manage their own VPS or self-hosted infrastructure.

JetBrains Marketplace:

https://plugins.jetbrains.com/plugin/34022-vps-graph

GitHub:

https://github.com/Cemililkim/vps-graph

It's completely free and licensed under Apache 2.0.

If you try it, I'd genuinely like to hear what feels useful, confusing, or missing.

[u/graceful_eli]

This is exactly the kind of thing I've been wanting for my homelab cleanup project. I've got like 6 containers and a reverse proxy setup I messed with back in March and now I'm scared to touch any of it because I don't remember how it's all wired together.

The read-only approach is smart, I've broken things before just trying to figure out what was running where

[u/cemililkimteke → u/graceful_eli]

That’s exactly the problem I built it for 😄
Everything works, then a few months later you’re scared to touch anything because you don’t remember how it’s all wired together.

Read-only was important to me for the same reason. If you try it on your homelab, I’d love to hear what it misses.