Skip to main content

​
Monitor Network Connections Visually

psys helps you understand which processes expose ports and how they connect to other services through interactive diagrams and detailed connection tables.

Get StartedExplore Features

​
Quick start

1

Install dependencies

Clone the repository and install dependencies with npm:
git clone https://github.com/alexcgomez/psys.git
cd psys
npm install
2

Run the development server

Start the Next.js development server:
npm run dev
Open http://localhost:3000 in your browser. The page will automatically refresh every 5 seconds to show current connections.
3

View your connections

psys displays two views:
  • Diagram: Interactive network graph showing listeners (left) and their outgoing connections (right)
  • Table: Detailed table with process names, ports, addresses, and connection information
psys uses the ss command to gather connection data. You’ll see processes owned by your user. For system-wide visibility, run with elevated permissions (not recommended for daily use).

​
Key features

Interactive Diagrams

Visualize network connections with React Flow diagrams showing listeners and their targets

Process Monitoring

Track which processes expose ports with real-time updates every 5 seconds

Docker Integration

Automatically detect and label Docker container port mappings

Connection Analysis

See established connections between local processes and remote services

​
What you can do with psys

​
Debug port conflicts

Quickly identify which process is using a specific port by scanning the listeners table or filtering the diagram view.

​
Map service dependencies

Understand how your local services connect to databases, APIs, and other backend systems.

​
Monitor Docker containers

See which Docker containers expose ports to the host and track their network activity.

​
Manage running processes

Terminate processes directly from the table view with a single click using SIGTERM signals.

​
Platform requirements

psys is designed for Linux systems only. It relies on the ss command and /proc filesystem to gather process and connection data.
Required:
  • Linux operating system
  • ss command (from iproute2 package)
  • Node.js 22+ and npm
Optional:
  • Docker (for container detection and labeling)

​
Ready to get started?

​
Start monitoring your connections

Follow the quickstart guide to install psys and view your first network diagram in minutes.

View Quickstart Guide