Skip to content

This user manual provides step-by-step instructions for using the setup-xrdp.sh script to set up XRDP on various Debian-based desktop systems.

License

Notifications You must be signed in to change notification settings

kusal-tharindu/debian-xrdp-setup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Debian-XRDP-setup ⚡️ GitHub GitHub stars GitHub forks

Debian-XRDP-setup

User Manual for the setup-xrdp.sh Script

The setup-xrdp.sh script is designed to automate the installation and configuration of XRDP on various Debian-based desktop systems. XRDP is an open-source implementation of the Microsoft Remote Desktop Protocol (RDP), which allows you to access your desktop environment remotely from another computer.


Table of Contents


Introduction

The setup-xrdp.sh script automates the installation and configuration of XRDP on various Debian-based desktop systems. Supported distributions include:

  • Ubuntu Desktop
  • Kali Linux
  • Debian
  • Linux Mint
  • Elementary OS
  • Zorin OS
  • MX Linux
  • Parrot OS

System Requirements

  • A Debian-based desktop system (as listed above)
  • Internet connection to download necessary packages
  • Root or sudo privileges

Pre-requisites

  1. Ensure your system is up to date:
    sudo apt update && sudo apt upgrade -y
  1. Install Git if it's not already installed:
    sudo apt install git -y

Installation Steps

  1. Clone the Repository

    Clone the debian-xrdp-setup repository to your local machine:

    git clone https://github.com/yourusername/debian-xrdp-setup.git
  1. Navigate to the Script Directory

    Change to the directory where the script is located:

    cd debian-xrdp-setup
  1. Make the Script Executable

    Ensure the script has executable permissions:

    chmod +x setup-xrdp.sh

Usage Instructions

  1. Run the Script

    Execute the script with sudo privileges:

    sudo ./setup-xrdp.sh
  1. Choose Your Distribution

    When prompted, enter the number corresponding to your Debian-based distribution:

Please enter the number corresponding to your Debian-based distribution: 

1. Ubuntu Desktop 
2. Kali Linux 
3. Debian 
4. Linux Mint 
5. Elementary OS 
6. Zorin OS 
7. MX Linux 
8. Parrot OS Enter your choice (1/2/3/4/5/6/7/8):       
  1. Follow the On-Screen Instructions

    The script will guide you through the installation process, displaying messages and statuses for each step. It will:

    • Update your system
    • Install XRDP
    • Install the appropriate desktop environment (XFCE)
    • Configure XRDP to use XFCE
    • Enable and start the XRDP service
    • Configure the firewall (if ufw or firewalld is installed)

Troubleshooting

If you encounter any issues during the installation, refer to the following log files for troubleshooting:

  • /var/log/xrdp.log
  • /var/log/xrdp-sesman.log

Additional Information

  • Connecting from Windows: Use the "Remote Desktop Connection" application and enter the IP address of your Debian-based machine.
  • Connecting from Linux: Use a Remote Desktop client like Remmina and select the RDP protocol.

By following this user manual, you should be able to easily set up XRDP on your Debian-based desktop system and remotely connect to it using an RDP client.


Authors ✍

  • Kusal Tharindu

  •   - Kusal Tharindu

  • LinkedIn Twitter GitHub

Wanna read my articles?


License 📄

This project is licensed under the MIT License.

Find out more details: LICENSE.md


Fair Use Act Disclaimer 🛑

This project is for educational purposes only.

Fair Use Copyright Disclaimer under section 107 of the Copyright Act of 1976, allowance is made for “fair use” for purposes such as criticism, comment, news reporting, teaching, scholarship, education and research. Fair use is a use permitted by copyright statute that might otherwise be infringing.

Find out more details: Disclaimer.md


Acknowledgments 🎁

I was motivated to create this project because I wanted to contribute on something useful for the dev community.

Many thanks to all my contributors who helped make this project a reality.


You can help me by Donating 💰

Buy Me A Coffee


Contact Me 📞

If you have any questions about this Privacy Policy, You can contact us:

About

This user manual provides step-by-step instructions for using the setup-xrdp.sh script to set up XRDP on various Debian-based desktop systems.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages