• Shell 88.4%
  • Dockerfile 11.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Claude Assistant 7526e821f1 📚 Update README.md for Claude-enhanced fork
- 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>
2025-05-26 00:28:31 +02:00
.github Bot Updating Templated Files 2025-02-02 23:37:40 +00:00
root 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
.cursorrules.md rdesktop codium 2025-01-14 10:48:28 +00:00
.editorconfig Bot Updating Templated Files 2023-02-11 16:28:32 +01:00
.env.example 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
.gitignore Bot Updating Templated Files 2021-02-13 10:23:09 -05:00
build-claude.sh 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
CLAUDE.md 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
docker-compose.claude.yml 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
docker-compose.coolify.yml 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
docker-compose.yml rdesktop codium 2025-01-14 10:48:28 +00:00
Dockerfile refresh alpine-xfce 2024-08-06 16:46:37 -04:00
Dockerfile.aarch64 refresh alpine-xfce 2024-08-06 16:46:37 -04:00
Dockerfile.claude-nvidia 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
Dockerfile.claude-nvidia-hue 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
Dockerfile.nvidia rdesktop codium 2025-01-14 10:48:28 +00:00
jenkins-vars.yml Rebase to 3.20 2024-05-27 18:32:24 +01:00
Jenkinsfile Bot Updating Templated Files 2025-02-09 23:35:50 +00:00
LICENSE adding focal xfce flavor 2020-03-15 17:27:24 -07:00
package_versions.txt Bot Updating Package Versions 2025-05-18 23:47:23 +00:00
README-claude.md 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
README-coolify.md 🎨🚀 Add Claude CLI RDP environment with Nvidia GPU support and Coolify integration 2025-05-25 18:27:36 +02:00
readme-vars.yml Bot Updating Templated Files 2025-05-18 23:35:37 +00:00
README.md 📚 Update README.md for Claude-enhanced fork 2025-05-26 00:28:31 +02:00
README.nvidia.md rdesktop codium 2025-01-14 10:48:28 +00:00
setup-nvidia.sh rdesktop codium 2025-01-14 10:48:28 +00:00

🚀 Claude-Enhanced RDesktop - GPU-Accelerated Remote Desktop with AI

Claude Enhanced Nvidia GPU Coolify Ready

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_KEY and 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

🔧 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:


linuxserver.io

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:

License

This project inherits the license from the original LinuxServer.io docker-rdesktop project.