Remote development environment with full desktop, IDE, and testing tools accessible via web or RDP

Welcome to DevEnv Pro

What is DevEnv Pro?

DevEnv Pro is a containerized remote development environment that gives you a complete Linux desktop experience with professional development tools — all accessible through your web browser or via RDP.

Think of it as your "cloud development machine" that you can:

Deploy anywhere — Local machine, VPS, or cloud provider
Access from anywhere — Web browser, RDP client, or SSH
Use for anything — Web development, testing, CI/CD, learning, or remote work

DevEnv Pro provides a complete Linux desktop environment with VS Code, testing tools, and modern CLI utilities — all accessible through your browser or via RDP.

Why Use DevEnv Pro?

🎯 For Developers

Consistent Environment — Same tools and configuration across all your projects
Isolated Development — Keep your development environment separate from your host machine
Quick Setup — Get started in minutes with a single docker compose up command
No Installation Hassles — All tools pre-installed and configured

🌐 For Remote Teams

Shared Development Environment — Team members work in identical setups
Browser-Based Access — No VPN or special client software required
Persistent Workspaces — Your work is saved across sessions with Docker volumes

🧪 For Testing & CI/CD

Pre-Installed Browsers — Playwright with Chromium, Firefox, and WebKit
Headless Operation — Run tests without a display using Xvfb
Integration Ready — Perfect for CI/CD pipelines and automated testing

📚 For Learning & Teaching

Safe Playground — Experiment without affecting your main machine
Complete Toolchain — Learn modern development tools and workflows
Reproducible Demos — Share exact environment configurations for workshops

Live Demo

Access a live instance of DevEnv Pro deployed on Coolify:

🖥️ Guacamole Web Desktop

Access the full XFCE4 desktop directly in your browser.

Launch Web Desktop →

Requires login credentials configured in deployment

💻 Browser-Based VS Code

Use VS Code directly in your browser with full extension support.

Open Code-Server →

Password protected — see deployment configuration

🚀 Main Dev Environment

Access the primary development container with all tools.

Access DevEnv →

Guacamole proxy daemon for RDP/VNC/SSH connections

Want your own deployment? Follow the Quick Start guide to deploy DevEnv Pro on your own infrastructure.

Features

🖥️ Full Desktop Environment

Complete XFCE4 desktop environment accessible via:

Web Browser - Apache Guacamole for browser-based access
RDP Client - Connect from any RDP client (Windows, Mac, Linux)
Virtual Display - Xvfb for headless operation

💻 Development Tools

Everything you need for professional development:

VS Code Desktop - Native VS Code with full extensions support
Code-Server - Browser-based VS Code as fallback
Bun v1.1.43 - Modern JavaScript runtime
Node.js v22 - Latest Node.js
Python 3 - With pip and venv support

🧪 Testing Framework

Playwright - E2E testing framework
Browsers - Chromium, Firefox, WebKit pre-installed

🔧 Modern CLI

Alacritty - GPU-accelerated terminal emulator
ZSH + Oh My Posh - Modern shell with beautiful prompt
Tmux - Terminal multiplexer with custom utilities
Lazygit - Terminal UI for Git
Modern replacements - bat, eza, btop, ripgrep, fd-find, fzf

🔌 Integrations

GitHub CLI - Command-line GitHub integration
Claude Code - AI assistant with model switcher
JetBrains Gateway - SSH support for JetBrains IDEs

Quick Access

Access Method	URL / Address	Purpose
🌐 Web Desktop	http://localhost:8081/guacamole	Full XFCE4 desktop in browser
💻 Code-Server	http://localhost:8443	VS Code in browser
🖥️ RDP Client	`rdp://localhost:3389`	Native desktop experience
🔌 SSH Terminal	`ssh root@localhost -p 2222`	Command-line access

Default Credentials: When starting locally, use the passwords defined in your .env file. Never use default credentials in production.

Quick Start

Clone and configure:

git clone https://github.com/MKS2508/mks-dev-environment.git
cd mks-dev-environment/docker
cp .env.example .env

Start services:

docker compose up -d

Initialize Guacamole:

cd guacamole
chmod +x init.sh
./init.sh

This initializes the database and creates a default connection.

Access your environment:

Web Desktop: http://localhost:8081/guacamole
Code-Server: http://localhost:8443
SSH: ssh root@localhost -p 2222
RDP: rdp://localhost:3389

Architecture

What's Included

Component	Description
devenv-full	Main container with desktop, IDE, tools
guacamole-postgres	PostgreSQL database for Guacamole
guacamole-guacd	Guacamole proxy daemon
guacamole	Web UI for remote desktop access

Common Use Cases

Web Development

# Clone your repo and start coding
git clone https://github.com/your/repo.git
cd repo
bun install
bun run dev

Access via Guacamole web desktop with VS Code Desktop pre-installed.

E2E Testing

# Run Playwright tests with all browsers
bunx playwright test

Chromium, Firefox, and WebKit browsers are pre-installed and configured.

Remote Development

# SSH into your environment from anywhere
ssh root@your-server-ip -p 2222

Work from any device with an SSH client or web browser.

Learning & Experimentation

# Try new tools without affecting your host
bunx create-next-app@latest my-app
cd my-app
bun run dev

Safe playground for learning new frameworks and tools.

Deployment Options

Option	Best For	Setup Time
Local Docker	Development & testing	~5 minutes
VPS + Coolify	Production deployment	~15 minutes
Cloud Provider	Scalable infrastructure	~30 minutes

Production Ready: DevEnv Pro is designed for production use with proper security, persistent volumes, and easy scaling via Docker Compose or Coolify.

Documentation

Explore the documentation to learn more:

Quick Start - Get up and running
Installation - Detailed setup guide
Architecture - Technical deep dive
Configuration - Environment variables
Guacamole Setup - Web desktop configuration
CLI Tools - Command-line interface
MCP Server - AI-powered management
Tmux Utilities - Session management

DevEnv Pro