How muhammadusamamx/chrome-isolation works
Chrome Isolation Manager is a GNOME/Electron desktop app for creating and operating isolated Chrome profiles in Docker. The main workflow runs from profile management in the UI, through stdio JSON IPC and backend profile operations, to a per-profile container that launches Chromium. Supporting branches cover proxy management, safe profile import/export, and GNOME desktop entries. Edges reflect README documentation and shown source references; container-image internals are described in the README, but their implementation was not sampled.
Main entry points: docker_manager.py Container lifecycle · profile_service.py Profile operations · Dockerfile Isolated Chrome image · registry.py Profile registry
Components 20
Desktop app
- Profile UI
electron/renderer/app.js - Secure API
electron/preload.js - Electron main
electron/main.js
Backend services
- Stdio bridge
backend/bridge.py - Profile operations
backend/profile_service.py - Path configuration
backend/config.py - Input validation
backend/validator.py
Profile data
- Profile registry
backend/registry.py - Profile archives
backend/archive.py - Proxy store
backend/proxy_store.py
Container runtime
- Container lifecycle
backend/docker_manager.py - Isolated Chrome image
Dockerfile - Stealth launch
scripts/docker/stealth-launch.sh - Hardware fingerprint
scripts/docker/hardware-spoof.sh - User-agent spoofing
scripts/docker/user-agent-spoof.sh - Proxy auth wrapper
scripts/docker/proxy-wrapper.py
Integrations
- GNOME entries
backend/desktop_manager.py - Docker daemon
- Host desktop
Other components
- User
Connections 25
- User → Profile UI: uses
README.md - Profile UI → Secure API: calls API
README.md - Secure API → Electron main: forwards IPC
README.md - Electron main → Stdio bridge: sends JSON
README.md - Stdio bridge → Profile operations: dispatches
backend/bridge.py - Stdio bridge → Proxy store: dispatches
backend/bridge.py - Profile operations → Profile registry: manages profiles
backend/profile_service.py - Profile operations → Container lifecycle: controls lifecycle
backend/profile_service.py - Profile operations → Profile archives: imports/exports
backend/profile_service.py - Profile operations → GNOME entries: manages entries
backend/profile_service.py - Profile operations → Input validation: validates inputs
backend/profile_service.py - Container lifecycle → Profile registry: reads profile
backend/docker_manager.py - Container lifecycle → Proxy store: resolves proxy
backend/docker_manager.py - Container lifecycle → Docker daemon: starts containers
README.md - Container lifecycle → Isolated Chrome image: runs image
README.md - Isolated Chrome image → Stealth launch: starts with
README.md - Isolated Chrome image → Hardware fingerprint: configures fingerprint
README.md - Isolated Chrome image → User-agent spoofing: sets user-agent
README.md - Container lifecycle → Proxy auth wrapper: uses for auth
README.md - Container lifecycle → Host desktop: mounts preferences
README.md - Profile archives → Profile registry: registers import
backend/archive.py - Profile archives → Input validation: validates names
backend/archive.py - GNOME entries → Input validation: validates names
backend/desktop_manager.py - Profile registry → Input validation: validates paths
backend/registry.py - Proxy auth wrapper → Docker daemon: runs in container