Turn a GitHub Actions Windows runner into a fully controllable remote workstation with RDP, SSH, Tailscale, Cloudflare Tunnel, WSL, Docker, Guacamole, AI-powered Telegram control, and more.
This workflow transforms a standard GitHub Actions Windows runner into a temporary cloud workstation that can be accessed and managed remotely.
Once started, the workflow automatically:
🔹 Enables Remote Desktop (RDP)
🔹 Installs and configures OpenSSH
🔹 Connects the machine to your Tailscale network
🔹 Creates secure remote access channels
🔹 Deploys a Telegram-controlled management bot
🔹 Installs workstation utilities and development tools
🔹 Supports Cloudflare Tunnel exposure
🔹 Provides AI assistance through Groq
The result is a fully interactive Windows environment accessible from anywhere.
The workflow automatically configures Windows Remote Desktop and generates a password for the runneradmin account.
Features:
- Automatic RDP activation
- Firewall rule configuration
- Password generation
- Remote GUI access
- Tailscale-compatible connection
Perfect for:
- Software testing
- Development
- Remote administration
- Browser automation
SSH access is enabled automatically.
This allows:
- Terminal access
- Script execution
- File management
- Automation workflows
The SSH service starts automatically and remains available during the workflow runtime.
Instead of exposing ports directly to the internet, the runner joins your private Tailscale network.
Benefits:
✅ End-to-end encryption
✅ Private networking
✅ Stable connectivity
✅ No router configuration required
✅ Direct RDP and SSH access
The runner receives its own Tailscale IP address and can even advertise itself as an Exit Node if desired.
The workstation can be managed entirely from Telegram.
After startup, the bot becomes your remote control panel.
Supported capabilities include:
Run:
- CMD commands
- PowerShell commands
- Linux commands through WSL
Examples:
/cmd ipconfig
/ps Get-Process
/wsl uname -a
Need to see what's happening?
/screenshot
The bot captures the active desktop and sends it directly back to Telegram.
/status
Displays information about:
- CPU usage
- Memory usage
- Network state
- Running services
- Workstation status
The bot supports:
⬆️ Uploading files to the workstation
⬇️ Downloading files from the workstation
Useful for:
- Source code
- Logs
- Installers
- Build artifacts
Integrated Groq AI support provides a built-in assistant directly inside Telegram.
Instead of memorizing commands, you can simply ask:
How do I install Docker?
or
Show me how to start Apache.
The assistant responds directly within Telegram and can help with workstation-related tasks and troubleshooting.
Need public access to a local service?
The workflow includes Cloudflared support.
Example:
/expose 8080
Returns a temporary public URL such as:
https://example.trycloudflare.com
Perfect for:
- Web applications
- APIs
- Development servers
- Dashboards
- Temporary demos
No port forwarding required.
The workstation can deploy Ubuntu through Windows Subsystem for Linux (WSL).
This provides:
- Native Linux tools
- Package management
- Docker support
- Bash environment
- Network utilities
You effectively get both Windows and Linux inside the same GitHub Actions runner.
Docker can be installed automatically during setup.
This enables:
- Containerized applications
- Development environments
- Self-hosted services
- Testing environments
Run Linux workloads directly from the temporary workstation.
For users who don't want to use a traditional RDP client, the workflow can deploy Apache Guacamole.
Benefits:
✅ Browser access
✅ No RDP software required
✅ Cross-platform compatibility
✅ Easy sharing and testing
Access your desktop directly through a web browser.
The workstation also includes several useful tools:
Measure:
- Download speed
- Upload speed
- Latency
Perform:
- Host discovery
- Port scanning
- Service enumeration
Useful for diagnostics and testing environments.
Create secure public tunnels for local services.
Additional networking tools are installed to assist with troubleshooting and connectivity management.
Several measures are implemented:
- Telegram user validation
- Private Tailscale networking
- Temporary GitHub runner environment
- Secure secret storage through GitHub Actions
- Optional Cloudflare exposure only when requested
Only the configured Telegram user is allowed to control the workstation.
Configure the following repository secrets:
| Secret | Description |
|---|---|
TAILSCALE_AUTH_KEY |
Tailscale authentication key |
TELEGRAM_BOT_TOKEN |
Telegram bot token |
TELEGRAM_CHAT_ID |
Authorized Telegram user |
RDP_PASS |
Your Static Password |
GROQ_API_KEY |
Groq API key |
CF_TUNNEL_TOKEN |
Cloudflare Tokens for Domain |
- Fork this repository
- Add all required GitHub Secrets
- Commit the workflow
- Open Actions
- Run RDP-v5.0 Azure Workstation
- Wait for provisioning
- Receive connection details through Telegram
- Connect via:
- Tailscale
- SSH
- RDP
- Guacamole
- Cloudflare Tunnel
GitHub Actions
│
▼
Windows Runner
│
├── RDP
├── SSH
├── Tailscale
├── Cloudflare Tunnel
├── Docker
├── WSL
├── Guacamole
└── Telegram Bot
│
▼
Groq AI
This project is intended for development, testing, automation, educational, and remote administration purposes.
Users are responsible for complying with:
- GitHub Actions Terms of Service
- Tailscale Policies
- Cloudflare Policies
- Local regulations and applicable laws
Spin up a cloud workstation in minutes, manage it from Telegram, access it through Tailscale, and tear it down when you're done.