Server Status Indicator
Colored status bar indicators for your running localhost dev servers — scoped to the current VS Code workspace.
Why?
Spinning up multiple dev servers across different terminals? Server Status Indicator gives you at-a-glance visibility right in the status bar. Each port gets its own colored dot so you always know what's running — and from which workspace.
Features
- Status Bar Indicators — Colored dots for each running server detected in the current workspace
- Workspace Scoped — Only shows servers whose working directory matches the open workspace, so multi-window setups stay clean
- Port-Specific Colors — Assign distinct colors to each port for instant identification
- Quick Pick Server Manager — Stop servers, add/remove watched ports, and change colors from a single menu (
Cmd+Shift+P → Show All Servers)
- Hover Diagnostics — Hover over any indicator to see PID, resolved CWD, and workspace match status
- Auto-Polling — Continuously monitors at a configurable interval
- Configurable Port List — Watch any set of ports you work with
Supported Ports (Defaults)
| Port |
Color |
Common Use |
| 3000 |
🔴 Red |
React, Next.js, Express |
| 3001 |
🔵 Blue |
Secondary dev server |
| 4200 |
🟣 Purple |
Angular |
| 5000 |
🟠 Orange |
Flask, .NET |
| 5173 |
🔵 Vite Blue |
Vite |
| 8000 |
🩷 Pink |
Django, Python |
| 8080 |
🩵 Cyan |
Tomcat, Spring |
| 8888 |
🟡 Yellow |
Jupyter |
All ports and colors are fully configurable in settings.
Commands
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and type Server Status:
| Command |
Description |
| Refresh |
Manually refresh server detection |
| Stop Server |
Choose a running server to stop |
| Show All Servers (Global) |
Manage servers, ports, and colors from a Quick Pick menu |
| Add Port |
Add a new port to the watch list |
| Remove Port |
Remove a port from the watch list |
| Set Port Color |
Change the status bar color for a specific port |
| Send Feedback |
Share feedback directly from VS Code |
| Support the Developer |
Open the support page |
Configuration
Add these settings to your settings.json or change them from the Settings UI:
| Setting |
Default |
Description |
serverStatusIndicator.pollingInterval |
5000 |
How often to check for servers (ms) |
serverStatusIndicator.portsToWatch |
[3000, 3001, 4200, ...] |
Ports to monitor |
serverStatusIndicator.portColors |
(per-port map) |
Map of port numbers to hex color strings |
serverStatusIndicator.defaultColor |
#4CAF50 |
Fallback color for ports without a custom color |
Example
{
"serverStatusIndicator.pollingInterval": 3000,
"serverStatusIndicator.portsToWatch": [3000, 5173, 8080],
"serverStatusIndicator.portColors": {
"3000": "#F44336",
"5173": "#646CFF",
"8080": "#00BCD4"
}
}
Requirements
- macOS or Linux (uses
lsof for process detection)
- VS Code 1.85 or later
Premium
Unlock advanced features like faster polling, unlimited watched ports, custom color themes, and more. Run Server Status: Buy Premium from the Command Palette or visit the Premium page to learn more.
Feedback & Support
- Send Feedback — Use the command
Server Status: Send Feedback to submit feedback directly from VS Code
- Support the Developer — If you find the extension useful, consider supporting development via the
Server Status: Support the Developer command
License
MIT
