RPort
  • RPort Knowledge Base
  • 👀WHAT IS RPORT
    • Features and benefits of RPort
      • Full feature list
    • Screenshots
    • Release Notes
      • 1.1.2
      • 1.1.0
      • 1.0.5
      • 1.0.4
      • 1.0.3
      • 1.0.2
      • 1.0.1
  • 🚀GETTING STARTED
  • Install the RPort Server
    • Launch RPort in the cloud
    • Install on-premises
    • Install on Vultr
    • Install on Azure
    • Install on AWS EC2
    • Install on Digital Ocean
    • Install on Scaleway
    • Install on Google Compute
    • Install on Hetzner Cloud
    • Install RPort on any virgin cloud VM
    • Change the FQDN of the RPort server
    • Enable two factor authentication
      • Use push on mobile for 2FA
      • Use TOTP
  • Connecting Clients
  • Using the remote access
    • Creating tunnels
      • VNC via browser
      • VNC via VNC® Viewer from RealVNC®
      • RDP via Browser
    • Open SSH from the browser
    • Scp,sftp through a tunnel
  • Renaming and tagging of clients
  • Organize clients with groups
  • Activate the vault
  • Manage users and permissions
  • Video Courses
    • Installation Preparation
    • Install on Prem
    • Install on Cloud
    • Client installation
    • Remote Access
    • Network communication
  • 🗣️ NEED HELP?
    • Troubleshoot common problems
      • RPort Server not starting
      • Restart rport through a tunnel
      • Attributes file path not set
      • Recover lost passwords
      • Client is not connecting
      • Id is already in use
  • 🔦DIGGING DEEPER
    • Using the API
      • Create client credentials
    • RPort Technology Explained
      • RPort Security Model
    • Commands and Scripts
      • Executing commands
      • Executing scripts
      • Tacoscript
    • The scheduler
    • File copy and reception
    • Client Configuration Options
      • Supervision of OS updates
      • Script and command execution
    • Advanced client management
      • Install the RPort client manually
      • Uninstall the RPort client
    • Server Maintenance
      • Monitoring of RPortd
      • Updating RPort
      • Backing up the rport server
      • Renewing certificates
    • FAQ
      • How to use Cloudflare
    • High Availability
    • Install on macOS
Powered by GitBook
On this page
  • Collect your configuration data
  • Install on macOS
  • Adapt the configuration to your needs

Was this helpful?

Export as PDF
  1. DIGGING DEEPER

Install on macOS

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

PreviousHigh Availability

Last updated 1 year ago

Was this helpful?

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.

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

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.

🔦
4KB
install_rport_macos.sh
Grab the client ID and password
Grab the fingerprint
Install from a terminal