GitHub - PATILYASHH/VPC

Quick Start | Downloads | Features | Self-Hosting | Contributing

An open-source, OS-style dashboard for managing your entire server infrastructure.

Install

One command to install VPC on any Ubuntu/Debian VPS:

curl -fsSL https://raw.githubusercontent.com/PATILYASHH/VPC/main/install.sh | sudo bash

The installer will:

Install Node.js, PostgreSQL, Nginx, PM2
Ask for your admin username, email, and password
Optionally configure a domain with SSL
Start VPC and show you the access URL + credentials

What is VPC?

VPC (Virtual PC Control) is a web-based desktop environment for managing your VPS. Instead of juggling terminals, dashboards, and tools — you get a single OS-like interface with windowed apps, a taskbar, and a launcher. Everything your server needs, in one place.

Think of it as your server's operating system in the browser.

Downloads

VPC Sync - VS Code Extension

Sync your local code with VPSHub repositories directly from VS Code. Push, pull, commit, branch — Git-like VCS built into your editor.

Platform	Download
VS Code	vpc-sync-8.0.0.vsix

Install manually:

code --install-extension vpc-sync-8.0.0.vsix

VPC CLI

Pull database migrations from VPSHub into your local projects.

Platform	Download
Node.js (18+)	vpc-sync-cli.tar.gz

Install:

npm install -g ./vpc-sync-cli.tar.gz

Features

Desktop Environment

A real desktop experience in your browser. Drag, resize, minimize, and multitask across windowed apps — just like a native OS.

Windowed multitasking with drag-and-drop
Taskbar with running app indicators
App launcher grid
Fullscreen mode
Theme customization

VPSHub - Code Collaboration

A self-hosted code platform with repositories, pull requests, issues, and deployment pipelines.

Create and manage Git-like repositories
Pull requests with merge, review, and comment
Issue tracking with labels
Branch management and commit history
File tree browsing with syntax highlighting
AI-powered code review (via Claude)
Smart merge conflict resolution

DB - Database Management

Full PostgreSQL management with project isolation, API generation, and schema versioning.

Create isolated database projects
Auto-generated REST APIs per project
SQL editor with query execution
Schema migrations with PR workflow
Storage buckets (S3-style file storage)
Auth system per project (users, JWT)
API key management (anon, service, pull)
Supabase import support

Web Hosting

Deploy and host websites directly from your VPC.

One-click site deployment
Custom domain support with SSL
Slug-based public URLs
Linked to VPSHub repos for auto-deploy

Server Management

Monitor and control your server infrastructure.

Server Manager - Real-time process and resource monitoring
Database Manager - PostgreSQL browser and query tool
Terminal - Execute commands directly from the browser
Logs Viewer - Application log monitoring and search
Backup Manager - Scheduled database backups with restore
Gallery - File browser with upload, preview, and bucket management

AI Agent (Jarvis)

An autonomous AI agent that lives on your server — thinks, diagnoses, and acts.

Multi-provider support: Anthropic Claude, OpenAI GPT, Ollama (local)
30+ built-in tools: deploy, restart, SQL, git, file ops, diagnostics
Autonomous task management with priority-based TODOs
Persistent memory across conversations
Telegram bot integration — chat with your server from your phone
Proactive alerts: deploy status, backup results, PR events, resource warnings
Approval workflow for dangerous operations (write files, run scripts)
Auto-diagnose issues: checks logs, services, disk, memory, DB health

Security

JWT authentication with TOTP (2FA) support
Role-based access control (RBAC)
Per-user app permissions
API key management with scoped access
IP restriction middleware
Full action audit logging

VS Code Integration

The VPC Sync extension brings VPSHub into your editor:

Push and pull code from VPSHub repos
Stage, commit, and branch — all from VS Code's Source Control panel
Auto-sync on configurable intervals
PAT token authentication

Tech Stack

Layer	Technology
Frontend	React 18, Vite, TailwindCSS, Radix UI, Zustand, React Query
Backend	Node.js, Express, PostgreSQL
Auth	JWT, TOTP, bcrypt
AI	Anthropic Claude, OpenAI GPT, Ollama (multi-provider)
Process Manager	PM2
Reverse Proxy	Nginx
Extension	VS Code SCM Provider API
CLI	Node.js

Quick Start

# Clone the repo
git clone https://github.com/PATILYASHH/VPC.git
cd VPC

# Install dependencies
npm install
cd backend && npm install && cd ..
cd frontend && npm install && cd ..

# Configure environment
cp backend/.env.example backend/.env
# Edit backend/.env with your database credentials

# Run migrations and seed admin
cd backend && node db/run-migrations.js && node db/seed-admin.js && cd ..

# Build frontend
cd frontend && npx vite build && cd ..

# Start
node app.js

Open http://localhost:8001 and log in with your admin credentials.

Self-Hosting

Full deployment guide for Ubuntu 22.04 VPS.

Prerequisites

Ubuntu 22.04+ (or any Linux with systemd)
Node.js 20+
PostgreSQL 14+
Nginx
A domain name (optional, for SSL)

1. Install Dependencies

apt update && apt upgrade -y

# Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

# PostgreSQL + Nginx + Certbot
apt install -y postgresql postgresql-contrib nginx certbot python3-certbot-nginx

# PM2
npm install -g pm2

# Enable services
systemctl enable postgresql nginx
systemctl start postgresql nginx

2. Setup Database

sudo -u postgres psql << 'SQL'
CREATE USER vpc_admin WITH PASSWORD 'YOUR_STRONG_PASSWORD';
CREATE DATABASE vpc OWNER vpc_admin;
GRANT ALL PRIVILEGES ON DATABASE vpc TO vpc_admin;
\c vpc
CREATE EXTENSION IF NOT EXISTS pgcrypto;
SQL

3. Install VPC

mkdir -p /var/www/vpc
git clone https://github.com/PATILYASHH/VPC.git /var/www/vpc
cd /var/www/vpc

npm install
cd backend && npm install && cd ..
cd frontend && npm install && cd ..

4. Configure

cp backend/.env.example backend/.env
nano backend/.env

NODE_ENV=production
PORT=8001
DB_HOST=localhost
DB_PORT=5432
DB_NAME=vpc
DB_USER=vpc_admin
DB_PASSWORD=YOUR_STRONG_PASSWORD
JWT_SECRET=your_random_64_char_string
JWT_EXPIRES_IN=24h
VPC_ADMIN_USERNAME=admin
VPC_ADMIN_EMAIL=admin@yourdomain.com
VPC_ADMIN_PASSWORD=your_admin_password
BACKUP_DIR=/var/backups/vpc
FRONTEND_URL=https://vpc.yourdomain.com

5. Build and Run

# Create directories
mkdir -p /var/backups/vpc uploads/gallery

# Run migrations + seed admin
cd backend && node db/run-migrations.js && node db/seed-admin.js && cd ..

# Build frontend
cd frontend && npx vite build && cd ..

# Start with PM2
pm2 start deploy/ecosystem.config.js
pm2 save && pm2 startup

6. Nginx + SSL

cp deploy/nginx-vpc.conf /etc/nginx/sites-available/vpc
# Edit: replace vpc.yourdomain.com with your domain
nano /etc/nginx/sites-available/vpc

ln -s /etc/nginx/sites-available/vpc /etc/nginx/sites-enabled/vpc
rm -f /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx

# SSL
certbot --nginx -d vpc.yourdomain.com

Your VPC is live at https://vpc.yourdomain.com

Updating

cd /var/www/vpc
git pull origin main
npm install
cd backend && npm install && cd ..
cd frontend && npm install && npx vite build && cd ..
cd backend && node db/run-migrations.js && cd ..
pm2 restart vpc

Or use the deploy script:

./deploy/deploy.sh

Project Structure

VPC/
├── app.js                       # Entry point
├── backend/
│   ├── server.js                # Express app
│   ├── routes/                  # API routes
│   ├── services/                # Business logic
│   ├── middleware/               # Auth, rate limiting, permissions
│   ├── migrations/              # SQL migrations (001-036)
│   └── db/                      # Migration runner, admin seeder
├── frontend/
│   └── src/
│       ├── components/
│       │   ├── desktop/         # Desktop shell, taskbar, launcher
│       │   ├── apps/            # App windows
│       │   ├── db/              # Database management UI
│       │   └── vpshub/          # Code collaboration UI
│       ├── stores/              # Zustand state management
│       └── lib/                 # Utilities, app registry
├── vscode-extension/            # VPC Sync VS Code extension
├── cli/                         # vpc-pull CLI tool
├── deploy/                      # PM2, Nginx, setup scripts
├── downloads/                   # Extension + CLI packages
└── uploads/                     # User files

PM2 Commands

Action	Command
Start	`pm2 start deploy/ecosystem.config.js`
Stop	`pm2 stop vpc`
Restart	`pm2 restart vpc`
Logs	`pm2 logs vpc`
Status	`pm2 status`

Contributing

We welcome contributions! Here's how to get started:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is open source and available under the MIT License.

Built with care by PATILYASHH

Name		Name	Last commit message	Last commit date
Latest commit History 75 Commits
backend		backend
cli		cli
deploy		deploy
downloads		downloads
frontend		frontend
imgs		imgs
vscode-extension		vscode-extension
.gitattributes		.gitattributes
.gitignore		.gitignore
DEPLOY_LOG.md		DEPLOY_LOG.md
LICENSE		LICENSE
README.md		README.md
VPC_CODE_REVIEW_REPORT.md		VPC_CODE_REVIEW_REPORT.md
app.js		app.js
install.sh		install.sh
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

Quick Start | Downloads | Features | Self-Hosting | Contributing

An open-source, OS-style dashboard for managing your entire server infrastructure.

Install

What is VPC?

Downloads

VPC Sync - VS Code Extension

VPC CLI

Features

Desktop Environment

VPSHub - Code Collaboration

DB - Database Management

Web Hosting

Server Management

AI Agent (Jarvis)

Security

VS Code Integration

Tech Stack

Quick Start

Self-Hosting

Prerequisites

1. Install Dependencies

2. Setup Database

3. Install VPC

4. Configure

5. Build and Run

6. Nginx + SSL

Updating

Project Structure

PM2 Commands

Contributing

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 5

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages