VPC

License Release Stars

VPC Desktop

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

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.

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

Install manually:

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

Pull database migrations from VPSHub into your local projects.

Install:

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

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

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

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

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

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

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

• 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

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

# 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.

Full deployment guide for Ubuntu 22.04 VPS.

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

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

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

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 ..

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

# 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

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

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

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

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

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

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

Built with care by PATILYASHH