RPort - remote access and remote management
Toggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage

RPort Plus

Overview

RPort Plus is a shared library needed to run the rport server.
Starting with rport version 1.0.0 loading the shared library into the rport server is required. The server denies starting without.

Installation

The downloaded .tar.gz package always includes the plus plugin that corresponds to the rport server version.

Copy the file rport-plus.so to any folder readable by the rport user, for example:

mkdir /usr/local/lib/rport
cp ./rport-plus.so /usr/local/lib/rport/rport-plus.so
chown rport cp ./rport-plus.so /usr/local/lib/rport/rport-plus.so

⚠️ CAUTION The plugin is compiled for a single version of rportd. Each rportd version will always be released with its corresponding plugin version.

Configuration

To use the RPort Plus functionality, the RPort Plus plugin must be loaded by RPort and the location of the plugin must be specified in the rportd configuration file. The [plugin] section and plugin_path option must both be set.

[plugin]
plugin_path = "/usr/local/lib/rport/rport-plus.so"

Starting with rportd version 1.0, the RPort Plus license details must be configured by setting the license id and key in the [license] section.

[license]
    id = "<your-license-id>"
    key = "<your-license-key>"
    ## An optional web proxy to be used for outbound connections
    # proxy_url = "http://user:pass@proxy.example.com:8080"

Restart rportd and check the plugin gets loaded.

$ service rportd restart
$ grep plus /var/log/rport/rportd.log
2022/10/26 15:31:40 rport-plus: plus manager initialized
2022/10/26 15:31:40 rport-plus: status capability initialized
2022/10/26 15:31:40 rport-plus: plus status capability registered

After a few minutes also check that your license was verified.

2022/10/26 15:32:45 rport-plus: runner: checker: verifying license key <your-license-id>
...
2022/10/26 15:33:50 rport-plus: runner: checker: verified <your-license-id>

For more information on configuring individual capabilities (such as SSO/OAuth), see the relevant sections of the RPort Plus documentation.