Webtop NVIDIA i3 Edition

A customized, high-performance Linux desktop in your browser, powered by LinuxServer.io Webtop. This setup is specifically tuned for Arch Linux, i3wm, NVIDIA GPUs, and Wayland support.

🚀 Features

• NVIDIA GPU Acceleration: Fully integrated with the NVIDIA Container Toolkit for hardware-accelerated rendering.
• Wayland Ready: Configured for Wayland support, enabling modern terminal emulators like Kitty.
• Pre-installed Tools:
  • Kitty: Fast, feature-rich terminal emulator.
  • Micro: Intuitive terminal-based text editor.
  • Fastfetch: Modern system information tool.
  • Git: Version control pre-configured.
• Persistence: Automated volume mapping for your dev projects, fonts, and editor configurations (kitty, micro).
• Custom Environment: Includes a refined .bashrc with a modern prompt and Git integration.

🛠️ Prerequisites

Before starting, ensure you have the following installed on your host machine:

1. Docker and Docker Compose.
2. NVIDIA Container Toolkit: Required for GPU passthrough.
   • Installation Guide

🏃 Quick Start

Start the Webtop

Use the provided script to clean up stale locks and launch the container:

./startWebtop.sh

Once started, access the desktop at: http://localhost:3300

Stop the Webtop

./stopWebtop.sh

📂 Project Structure

• Dockerfile: Custom Arch-based image with extra tools and graphics libraries.
• docker-compose.yml: Container orchestration with NVIDIA runtime and volume mappings.
• config/.bashrc: Custom shell environment for the container.
• startWebtop.sh: Handles initialization, library refreshing (ldconfig), and startup.

🔧 Customization

You can modify the docker-compose.yml to change volume mappings or ports. By default:

• Port: 3300
• Data Dir: /home/nui/dev is mapped to /config/dev inside the container.
• Config: Local ~/.config/kitty and ~/.config/micro are synced for a consistent experience.