Building on OSX (not official)

Disclaimer

xrdp on macOS is not officially supported by the xrdp team so far, but we welcome your contributions and volunteers. This document is brought by contributors. Feel free to edit this document but we xrdp team are not involved xrdp on macOS.

To whom want to use xrdp on macOS, SHARE YOUR KNOWLEDGE WITH EACH OTHER.

There's also a gitter chatroom to have talk with xrdp on Mac users.

• https://gitter.im/neutrinolabs/xrdp-mac

Building xrdp on OSX

Work in progress.

Since Mac OS 10.10, the OpenSSL headers are not included with the Xcode command line tools. The libraries are available, but they are obsolete (0.9.8). Linking xrdp against those old libraries will fail. You'll need OpenSSL from MacPorts or Homebrew.

Prerequisites

• Install Xcode command line tools: xcode-select --install
• Install Homebrew: http://brew.sh/
• Install OpenSSL from Homebrew: brew install openssl
• Install Automake + Autoconf: brew install automake
• Instal Libtool: brew install libtool
• Install pkgconfig: brew install pkgconfig
• Install nasm: brew install nasm (needed by librfxcodec)
• Install XQuartz: https://www.xquartz.org/

Build xrdp

Get the release tarball xrdp-0.9.1.tar.gz and unpack it.

./bootstrap
./configure PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig
make
sudo make install

I had to do ./configure PKG_CONFIG_PATH=/opt/homebrew/opt/openssl/lib/pkgconfig

Build xorgxrdp

Get the release tarball xorgrdp-0.2.0.tar.gz and unpack it.

./bootstrap
./configure PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig
#on Big Sur I had to use following command: ./configure PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig:/usr/local/lib/pkgconfig
make
sudo make install

To compile xorgxrdp I had to do: brew install xorgproto

Ok, whats next?

• The remaining work is to be able to start X with the xrdpxorg module. This is the actual stopper.

• service is in ...

❯ which xrdp
/usr/local/sbin/xrdp

• a launchDaemon will be responsible to start the service (not needed for the moment)

• can run sudo /usr/local/sbin/xrdp and connect via client.. but produces black screen why? (Perhaps no window manager?)

• I don't know if this is related but on Debian it is a common issue that you only get a black screen when connecting if you are still logged in on the host. I will compile this and try this myself, the solution I see would be running xrdp via daemon and logging out before connecting.

Common Troubleshooting Notes

Unknown Type Error

Error: Compiling xrdp fails and the console spits out a bunch of unknown type errors

Example: /usr/include/sys/resource.h:198:2: error: unknown type name 'uint64_t' uint64_t ri_system_time; ^

Fix: The local libraries in /usr/local/include directory are outdated despite updated libraries being installed on the system as part of the OSX commandline tools. As a workaround to tell g++/clang to ignore the outdated libaries in this directory, change the directory name:

# mv /usr/local/include /usr/local/include_old

Make sure you re-run the configuration generation before compiling again:

./bootstrap
./configure PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig

Tested Versions: MacOS 10.14.3 with XRDP v0.9.9

'X11/fonts/libxfont2.h' file not found

Error Message:

/Library/Developer/CommandLineTools/usr/bin/make all-recursive
Making all in module
CC rdpDraw.lo
In file included from rdpDraw.c:44:
/opt/X11/include/xorg/dixfontstr.h:30:10: fatal error: 'X11/fonts/libxfont2.h' file not found
#include <X11/fonts/libxfont2.h>
^~~~~~~~~~~~~~~~~~~~~~~
1 error generated.
make[3]: *** [rdpDraw.lo] Error 1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2

Fix: Modify the file /opt/X11/include/xorg/dixfontstr.h. Change the include statement into:

#include "../X11/fonts/libxfont2.h"

Tested Versions: MacOS 11.0.1 with XRDP v0.9.15

Possible Source of Insight

Has anyone looked into the changes made by this user on MacRumors? https://forums.macrumors.com/threads/how-to-control-your-mac-using-win-rdp-client-xrdp-compiling-guide-on-osx.1770325/

He or she packaged everything up with version 0.6.0 (ancient, yes), but it just works on MacOS Mojave, as long as you disable SIP before installing (haven't tested on Catalina).

(I apologize if this is the wrong place to put this. I couldn't find any open issues that seemed fitting. Feel free to delete/move this where appropriate...)