Install on macOS

How to install the rport client on macOS (Intel & ARM)

While the built-in pairing option does not provide an option to install the RPort client on macOS, RPort does support macOS. A full integration into the user interface is underway. Meanwhile, follow this instruction to connect your macOS device to your RPort server.

Collect your configuration data

To install and connect a device manually to RPort you will need the following data:

  1. The connect URL: It equals your server FQDN. This is usually the URL used to access the RPort user interface, but without the https:// part and without and path. Using the IP address of your server is possible too. If the rport server doesn't use port 80 for the client connection, append the port number with a colon to the server FQDN. Example: Do not append the port used for the web user interface, typically 443. Adding a scheme such as http:// is optional and only required if the connection is not using http.

  2. The client ID and password: Copy this data from Settings->Client Access. The client ID and password are case-sensitive.

  3. The fingerprint of your server. Go to Settings->Info

Install on macOS

With all the information at hand, you can download the installation script and execute it.

  1. Click on the link below at the end of the article and save the script somewhere, for example in your default downloads folder.

  2. Open a terminal and change the directory to where you have downloaded the script.

  3. Execute the script as follows: sudo sh --url <connect_url> --clientid <ID> --password <password> --fingerprint <fingerprint>

Adapt the configuration to your needs

With the above steps, you only get a very basic installation using the minimal defaults. Tunnels will be enabled, but command and script execution not.

Open the file /etc/rport/rport.conf with an editor and change to your needs. Only root can edit this file, so use sudo open /etc/rport/rport.conf to open it. Save your changes and restart rport to apply them using sudo launchctl stop rport; sudo launchctl start rport.

Last updated