xrdp: an open source RDP server
C C++ M4 Makefile Shell AngelScript
Clone or download
Permalink
Failed to load latest commit information.
common fix issue #1112: set SSL object's read_ahead flag to be 0 May 21, 2018
docs docs: fix xrdp's LogFile path in man Jul 12, 2018
fontdump Don't ignore files known to git Feb 13, 2016
genkeymap Add dvorak keyboard layout Nov 1, 2017
instfiles FreeBSD: separate rc script into xrdp and xrdp-sesman May 29, 2018
keygen Eliminate APP_CC and DEFAULT_CC Mar 14, 2017
libpainter @ cc66c2c update submodules to their release tag head commit Mar 30, 2017
librfxcodec @ ef68593 update submodules to the latest release Dec 27, 2017
libxrdp libxrdp: fix memory leak Feb 13, 2018
m4 Update m4/ax_type_socklen_t.m4, it works with -Wall now Feb 3, 2017
mc Make changes to generate dylibs in mac again Jan 30, 2018
neutrinordp workaround for corrupted display with W2K8 Dec 18, 2017
pkgconfig Fix include path in xrdp-uninstalled.pc.in Nov 18, 2016
sesman chansrv: remove pulseaudio modules from xrdp source tree Aug 3, 2018
tcutils tcutils: fix WTSVirtualChannelWrite return codes check according to A… Sep 13, 2017
tests Eliminate APP_CC and DEFAULT_CC Mar 14, 2017
vnc Make changes to generate dylibs in mac again Jan 30, 2018
vrplayer Remove trailing whitespace Feb 8, 2017
xrdp xrdp: unify inconsistent mixed use of Jun 27, 2018
xrdpapi xrdp-ssh-agent: Remove vim modeline Oct 17, 2017
xrdpvr xrdpvr: adjust xrdpvr_write_to_client to xrdpapi API change Sep 13, 2017
xup Make changes to generate dylibs in mac again Jan 30, 2018
.gitignore .gitignore, change configure_params.h to xrdp_configure_options.h Aug 14, 2018
.gitmodules Use special name "." for the branches in .gitmodules Mar 2, 2017
.travis.yml travis: add build test on FDK AAC, Opus Nov 12, 2017
COPYING o moved from GNU General Public License to Apache License, Version 2.0 Sep 20, 2012
Makefile.am xrdp: unify inconsistent mixed use of Jun 27, 2018
NEWS.md Update v0.9.7 release date Jun 28, 2018
README.md Bump version to v0.9.7 Jun 28, 2018
astyle_config.as Remove --break-blocks option, it doesn't match the existing code style Feb 7, 2017
bootstrap bootstrap: checkout submodules if they are missing Dec 29, 2016
coding_style.md Merge prog_std.txt into coding_style.md Oct 17, 2016
configure.ac Bump version to v0.9.7 Jun 28, 2018
description-pak helper file for checkinstall Mar 20, 2013
design.txt More spelling fixes found by codespell and aspell Jan 31, 2016
faq-compile.txt Update faq-compile.txt May 30, 2014
faq-general.txt Fix incorrect use of "it's" and "its", adjust wording Jun 21, 2016
file-loc.txt Remove librdp.so sources, it's obsoleted by neutrinordp Jan 20, 2017
install.txt More spelling fixes found by codespell and aspell Jan 31, 2016
postinstall-pak clear things that are handled by the init script Mar 21, 2013

README.md

Build Status Gitter Apache-License

Current Version: 0.9.7

xrdp - an open source RDP server

Overview

xrdp provides a graphical login to remote machines using Microsoft Remote Desktop Protocol (RDP). xrdp accepts connections from a variety of RDP clients: FreeRDP, rdesktop, NeutrinoRDP and Microsoft Remote Desktop Client (for Windows, Mac OS, iOS and Android).

RDP transport is encrypted using TLS by default.

demo

Features

Remote Desktop Access

  • Connect to a Linux desktop using RDP from anywhere (requires xorgxrdp Xorg module)
  • Reconnect to an existing session
  • Session resizing
  • RDP/VNC proxy (connect to another RDP/VNC server via xrdp)

Access to Remote Resources

Quick Start

Most Linux distributions should distribute the latest release of xrdp in their repository. You would need xrdp and xorgxrdp packages for the best experience. It is recommended that xrdp depends on xorgxrdp, so it should be sufficient to install xrdp. If xorgxrdp is not provided, use Xvnc server.

xrdp listens on 3389/tcp. Make sure your firewall accepts connection to 3389/tcp from where you want to access.

Ubuntu / Debian

apt install xrdp

RedHat / CentOS / Fedora

On RedHat and CentOS, make sure to enable EPEL packages first.

yum install epel-release

Install xrdp package.

yum install xrdp

yum is being replaced with dnf, so you may need to use dnf instead of yum in the above commands.

Environment

xrdp primarily targets to GNU/Linux. Tested on x86, x86_64, SPARC and PowerPC.

xorgxrdp and RemoteFX Codec have special optimization for x86 and x86_64 using SIMD instructions.

FreeBSD is not a primary target of xrdp. It is working on FreeBSD except for the drive redirection feature.

Other operating systems such as macOS are not supported so far, but we welcome your contributions.

Compiling

See also https://github.com/neutrinolabs/xrdp/wiki#building-from-sources

Prerequisites

To compile xrdp from the packaged sources, you need basic build tools - a compiler (gcc or clang) and the make program. Additionally, you would need openssl-devel, pam-devel, libX11-devel, libXfixes-devel, libXrandr-devel. More additional software would be needed depending on your configuration.

To compile xrdp from a checked out git repository, you would additionally need autoconf, automake, libtool and pkgconfig.

Get the source and build it

If compiling from the packaged source, unpack the tarball and change to the resulting directory.

If compiling from a checked out repository, please make sure you've got the submodules cloned too (use git clone --recursive https://github.com/neutrinolabs/xrdp)

Then run following commands to compile and install xrdp:

./bootstrap
./configure
make
sudo make install

If you want to use audio redirection, you need to build and install additional pulseaudio modules. The build instructions can be found at wiki.

Directory Structure

xrdp
├── common ······ common code
├── docs ········ documentation
├── fontdump ···· font dump for Windows
├── genkeymap ··· keymap generator
├── instfiles ··· installable data file
├── keygen ······ xrdp RSA key pair generator
├── libpainter ·· painter library
├── librfxcodec · RFX codec library
├── libxrdp ····· core RDP protocol implementation
├── m4 ·········· Autoconf macros
├── mc ·········· media center module
├── neutrinordp · RDP client module for proxying RDP connections using NeutrinoRDP
├── pkgconfig ··· pkg-config configuration
├── sesman ······ session manager for xrdp
├── tcutils ····· QT based utility program for thin clients
├── tests ······· tests for the code
├── vnc ········· VNC client module for xrdp
├── vrplayer ···· QT player redirecting video/audio to clients over xrdpvr channel
├── xrdp ········ main server code
├── xrdpapi ····· virtual channel API
├── xrdpvr ······ API for playing media over RDP
└── xup ········· X11rdp and xorgxrdp client module