# Install on macOS

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

   <figure><img src="/files/YoRVlfEv4scQQDbzifRc" alt=""><figcaption><p>Grab the client ID and password</p></figcaption></figure>
3. The **fingerprint** of your server. `Go to Settings->Info` <br>

   <figure><img src="/files/mDrFODcLfqWLRnqBVVqR" alt=""><figcaption><p>Grab the fingerprint</p></figcaption></figure>

### 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.&#x20;
2. Open a terminal and change the directory to where you have downloaded the script.&#x20;
3. Execute the script as follows:\
   `sudo sh install_rport_macos.sh --url <connect_url> --clientid <ID> --password <password> --fingerprint <fingerprint>`\
   &#x20;

   <figure><img src="/files/zdYr5HrFHt6EDhn2WFOx" alt=""><figcaption><p>Install from a terminal</p></figcaption></figure>

### 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.&#x20;

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

{% file src="/files/DHFMZ8X2Cuu3AGSLMjib" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.rport.io/digging-deeper/install-on-macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.