xrdp: an open source RDP server
C C++ M4 Shell Makefile ActionScript
Latest commit 92d9f2e Jan 23, 2017 @speidy speidy committed on GitHub Merge pull request #627 from proski/openssl
Check for openssl binary in configure, don't fail if not found
Permalink
Failed to load latest commit information.
common Merge pull request #426 from metalefty/log-tls-version-and-cipher Jan 16, 2017
docs Document --port and --fork options for xrdp Jan 18, 2017
fontdump Don't ignore files known to git Feb 13, 2016
genkeymap Distribute all files except git and github specific data Dec 18, 2016
instfiles Change BindTo to BindsTo, it was renamed in systemd long time ago Jan 20, 2017
keygen Check for openssl binary in configure, don't fail if not found Jan 22, 2017
libpainter @ 7156131 Update submodules to their v0.1.0 tags Dec 20, 2016
librfxcodec @ 03a3689 Update submodules to their v0.1.0 tags Dec 20, 2016
libxrdp Merge pull request #625 from speidy/proxy_session_info Jan 23, 2017
m4 Use PKG_INSTALLDIR to determine pkg-config file install location Nov 21, 2016
mc Constify the value argument to mod_set_param Jan 11, 2017
neutrinordp neutrinordp: add session_info Jan 15, 2017
pkgconfig Fix include path in xrdp-uninstalled.pc.in Nov 18, 2016
sesman Merge pull request #630 from selu/devel Jan 23, 2017
tcutils More spelling fixes found by codespell and aspell Jan 31, 2016
tests Add socklen_t check with substitution, use socklen_t as needed Sep 9, 2016
vnc Constify the value argument to mod_set_param Jan 11, 2017
vrplayer Typo fixes May 5, 2016
xorg Compile applewmproto before xorg-server Jan 18, 2017
xrdp Merge pull request #636 from proski/painter Jan 23, 2017
xrdpapi Use "void" for empty argument list in declarations Jan 6, 2017
xrdpvr Distribute all files except git and github specific data Dec 18, 2016
xup Constify the value argument to mod_set_param Jan 11, 2017
.gitignore Add *.a to top .gitignore, add xorg/X11R7.6/.gitignore Oct 10, 2016
.gitmodules Don't consider submodules dirty if they contain untracked files Jan 4, 2017
.travis.yml .travis.yml: use -Werror, test two configurations - minimal and maximal Jan 6, 2017
COPYING o moved from GNU General Public License to Apache License, Version 2.0 Sep 20, 2012
Makefile.am Remove librdp.so sources, it's obsoleted by neutrinordp Jan 20, 2017
NEWS.md Add NEWS.md Dec 21, 2016
README.md Changes in README.md Dec 22, 2016
astyle_config.as o moved from GNU General Public License to Apache License, Version 2.0 Sep 20, 2012
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 Merge pull request #627 from proski/openssl Jan 23, 2017
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.txt Add README.md Dec 21, 2016

README.md

Build Status Gitter Apache-License

Current Version: 0.9.1

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

  • two-way clipboard transfer (text, bitmap, file)
  • audio redirection
  • drive redirection (mount local client drives on remote machine)

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.

Ubuntu / Debian

apt-get install xrdp

RedHat / CentOS / Fedora

yum install xrdp

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 Mac OS 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

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
├── rdp --------- RDP client module for connecting to another RDP server
├── 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
├── xorg -------- X11rdp, an Xorg backend for xrdp
├── xrdp -------- main server code
├── xrdpapi ----- virtual channel API
├── xrdpvr ------ API for playing media over RDP
└── xup --------- X11rdp and xorgxrdp client module