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. To connect your macOS device to your RPort server, follow these instructions.

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: rport.example.com:8080 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.

    Grab the client ID and password
  3. The fingerprint of your server. Go to Settings->Info

    Grab the fingerprint

Install on macOS

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

  1. Click on the install_rport_macos.sh 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 install_rport_macos.sh --url <connect_url> --clientid <ID> --password <password> --fingerprint <fingerprint>

    Install from a terminal

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