- Shell 88.4%
- Dockerfile 11.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- Add fork-specific header with badges for Claude, Nvidia, and Coolify - Highlight new features: Claude CLI auto-config, GPU support, user "hue" - Include quick start guides for both standard and Coolify deployments - Link to detailed documentation (README-claude.md, README-coolify.md) - Preserve original LinuxServer documentation below fork content - Add credits section acknowledging LinuxServer.io, Anthropic, and Nvidia This makes it clear this is an enhanced fork while respecting the original project\! 🙏 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
| .github | ||
| root | ||
| .cursorrules.md | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| build-claude.sh | ||
| CLAUDE.md | ||
| docker-compose.claude.yml | ||
| docker-compose.coolify.yml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| Dockerfile.aarch64 | ||
| Dockerfile.claude-nvidia | ||
| Dockerfile.claude-nvidia-hue | ||
| Dockerfile.nvidia | ||
| jenkins-vars.yml | ||
| Jenkinsfile | ||
| LICENSE | ||
| package_versions.txt | ||
| README-claude.md | ||
| README-coolify.md | ||
| readme-vars.yml | ||
| README.md | ||
| README.nvidia.md | ||
| setup-nvidia.sh | ||
🚀 Claude-Enhanced RDesktop - GPU-Accelerated Remote Desktop with AI
Fork of linuxserver/docker-rdesktop with Claude AI integration, enhanced GPU support, and Coolify deployment!
✨ What's New in This Fork
This fork adds powerful AI and GPU capabilities to the excellent LinuxServer.io RDesktop project:
- 🤖 Claude CLI Auto-Configuration - Set
ANTHROPIC_API_KEYand Claude works instantly! - 🎮 Full Nvidia GPU Support - CUDA, OpenGL, Vulkan with automatic detection
- 👤 Custom User "hue" - Changed from default "abc" for better personalization
- 🔐 Auto Password Generation - Secure random passwords on first run
- 🌊 Coolify Integration - Ready-to-deploy with proper labels and networking
- 🎯 Desktop Shortcuts - Quick access to Claude chat, code review, and GPU monitoring
- 🔊 Enhanced Audio - PulseAudio with equalizer and echo cancellation
🚀 Quick Start
Option 1: Standard Docker Compose
# Clone this fork
git clone https://github.com/YOUR-USERNAME/docker-rdesktop.git
cd docker-rdesktop
# Build the Claude-enhanced image
./build-claude.sh
# Set your Claude API key (optional but recommended)
export ANTHROPIC_API_KEY="your-api-key"
# Run with GPU support
docker-compose -f docker-compose.claude.yml up -d
Option 2: Deploy with Coolify
Use docker-compose.coolify.yml - password is auto-generated and Claude works instantly when you set the API key!
📖 Full Coolify deployment guide
🎯 Key Features
Claude AI Integration
- Instant Setup: Just set
ANTHROPIC_API_KEY- no login needed! - Desktop Shortcuts: Quick access to Claude chat and code review
- Pre-configured: Optimal settings for development assistance
GPU Acceleration
- Nvidia Support: Full CUDA, OpenGL, and Vulkan
- Auto-Detection: Configures GPU automatically
- Gaming Ready: Steam, Lutris pre-installed
Enhanced Desktop
- KDE Plasma: Beautiful, GPU-accelerated desktop
- Developer Tools: VS Code, Neovim, multiple terminals
- AI/ML Ready: PyTorch, TensorFlow, Jupyter pre-installed
📋 Documentation
- 🤖 Claude Integration Guide - Full Claude CLI setup and usage
- 🌊 Coolify Deployment - Deploy with auto-scaling and management
- 📖 Original LinuxServer Docs - Base container documentation
🔧 Configuration
Essential Environment Variables
| Variable | Description | Default |
|---|---|---|
ANTHROPIC_API_KEY |
Your Claude API key for instant setup | - |
RDP_PASSWORD |
Custom password (auto-generated if empty) | Random |
RDP_USERNAME |
Username for RDP login | hue |
PUID/PGID |
User/Group IDs | 1000 |
TZ |
Timezone | UTC |
Connection Details
- Protocol: RDP (Remote Desktop Protocol)
- Port: 3389
- Username:
hue - Password: Check container logs or
/config/rdp-credentials.txt
🎮 What's Included
Development
- Claude CLI (auto-configured!)
- Python, Node.js, Go, Rust
- PyTorch, TensorFlow
- Git, Docker, dev tools
Entertainment
- Steam & Lutris
- Discord
- OBS Studio
- GPU-accelerated games
Desktop
- KDE Plasma with effects
- Multiple terminals
- System monitoring
- Customizable themes
Original Documentation
Below is the original documentation from LinuxServer.io for the base rdesktop container:
The LinuxServer.io team brings you another container release featuring:
- regular and timely application updates
- easy user mappings (PGID, PUID)
- custom base image with s6 overlay
- weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
- regular security updates
Supported Architectures
We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.
Simply pulling lscr.io/linuxserver/rdesktop:latest should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
The architectures supported by this image are:
| Architecture | Available | Tag |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| armhf | ❌ |
Version Tags
This image provides various versions that are available via tags. Please read the descriptions carefully and exercise caution when using unstable or development tags.
| Tag | Available | Description |
|---|---|---|
| latest | ✅ | XFCE Alpine |
| ubuntu-xfce | ✅ | XFCE Ubuntu |
| fedora-xfce | ✅ | XFCE Fedora |
| arch-xfce | ✅ | XFCE Arch |
| debian-xfce | ✅ | XFCE Debian |
| alpine-kde | ✅ | KDE Alpine |
| ubuntu-kde | ✅ | KDE Ubuntu |
| fedora-kde | ✅ | KDE Fedora |
| arch-kde | ✅ | KDE Arch |
| debian-kde | ✅ | KDE Debian |
| alpine-mate | ✅ | MATE Alpine |
| ubuntu-mate | ✅ | MATE Ubuntu |
| fedora-mate | ✅ | MATE Fedora |
| arch-mate | ✅ | MATE Arch |
| debian-mate | ✅ | MATE Debian |
| alpine-i3 | ✅ | i3 Alpine |
| ubuntu-i3 | ✅ | i3 Ubuntu |
| fedora-i3 | ✅ | i3 Fedora |
| arch-i3 | ✅ | i3 Arch |
| debian-i3 | ✅ | i3 Debian |
| alpine-openbox | ✅ | Openbox Alpine |
| ubuntu-openbox | ✅ | Openbox Ubuntu |
| fedora-openbox | ✅ | Openbox Fedora |
| arch-openbox | ✅ | Openbox Arch |
| debian-openbox | ✅ | Openbox Debian |
| alpine-icewm | ✅ | IceWM Alpine |
| ubuntu-icewm | ✅ | IceWM Ubuntu |
| fedora-icewm | ✅ | IceWM Fedora |
| arch-icewm | ✅ | IceWM Arch |
| debian-icewm | ✅ | IceWM Debian |
Application Setup
The Default USERNAME and PASSWORD is: abc/abc
Unlike our other containers these Desktops are not designed to be upgraded by Docker, you will keep your home directory but anything you installed system level will be lost if you upgrade an existing container. To keep packages up to date instead use Ubuntu's own apt, Alpine's apk, Fedora's dnf, or Arch's pacman program
You will need a Remote Desktop client to access this container Wikipedia List, by default it listens on 3389, but you can change that port to whatever you wish on the host side IE 3390:3389.
The first thing you should do when you login to the container is to change the abc users password by issuing the passwd command.
Modern GUI desktop apps (including some flavors terminals) have issues with the latest Docker and syscall compatibility, you can use Docker with the --security-opt seccomp=unconfined setting to allow these syscalls or try podman as they have updated their codebase to support them
If you ever lose your password you can always reset it by execing into the container as root:
docker exec -it rdesktop passwd abc
By default we perform all logic for the abc user and we recommend using that user only in the container, but new users can be added as long as there is a startwm.sh executable script in their home directory.
All of these containers are configured with passwordless sudo, we make no efforts to secure or harden these containers and we do not recommend ever publishing their ports to the public Internet.
[Full original documentation continues below...]
Support Info
-
Shell access whilst the container is running:
docker exec -it rdesktop /bin/bash -
To monitor the logs of the container in realtime:
docker logs -f rdesktop -
Container version number:
docker inspect -f '{{ index .Config.Labels "build_version" }}' rdesktop -
Image version number:
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/rdesktop:latest
Credits
This fork builds upon the excellent work by:
- LinuxServer.io - Original rdesktop container
- Anthropic - Claude AI integration
- Nvidia - GPU drivers and CUDA toolkit
License
This project inherits the license from the original LinuxServer.io docker-rdesktop project.
