Installing the Graphics Agent for macOS¶

Before starting, be aware of the following conditions:

The macOS machine that will act as the PCoIP host must allow PCoIP traffic through its firewall. Firewall settings should be either:
- The firewall is off, or
- The firewall is on, and:
  - Automatically allow downloaded signed software to receive incoming connections is checked, or
  - Automatically allow downloaded signed software to receive incoming connections is not checked, and the following executables are allowed through the firewall:
    - /Applications/PCoIP Agent.app
    - /Applications/PCoIP Agent.app/Contents/MacOS/pcoip-agent
    - /Applications/PCoIP Agent.app/Contents/MacOS/pcoip-server
    If the firewall is on and Automatically allow downloaded signed software to receive incoming connections is not checked, you will be prompted to allow the above permissions during installation.
  Finding Automatically allow downloaded signed software to receive incoming connections
  
  The Automatically allow downloaded signed software to receive incoming connections setting is in System Preferences > Security & Privacy, under the Firewall tab. Click Firewall Options to reveal it. The Firewall Options button is only visible if the firewall is on.

Installing With the Interface¶

Download the installer to the machine you'll be using as the PCoIP host.

Contact Teradici for installer

The installer is not publicly available at this time. Contact Teradici for more information.
Run the installer pkg.
Click through the installer steps and accept the End User License Agreement. The agent application will be installed.
Open the PCoIP Agent application found in /System/Volumes/Data/Applications/PCoIP Agent.app.
You will be prompted to allow Accessibility and Screen Recording permissions. Grant and confirm privacy permissions for both Accessibility and Screen Recording.

Note: No user interface

The PCoIP Agent application launches PCoIP services which continue to run in the background. There is no user interface and no further direct interaction with the application. You do not need to launch PCoIP Agent.app again after installation.
Next, provide the license registration code you received from Teradici.

Important: This step does not apply for PCoIP License Server users

If you are using a local PCoIP License Server, do not follow this step; refer to Licensing the Graphics Agent for macOS.

If you are using Teradici Cloud Licensing, open a terminal window and type one of the following commands, depending on whether your host machine is behind a proxy server:
- If you use a proxy server to access the internet, provide this command (replace {REGISTRATION_CODE}, {PROXY_SERVER_ADDRESS}, and {PROXY_PORT_NUMBER} with your own values):
```
sudo pcoip-register-host --registration-code={REGISTRATION_CODE} --proxy-server={PROXY_SERVER_ADDRESS} --proxy-port={PROXY_PORT_NUMBER}
```
- If your system does not use a proxy server, provide this command (replace {REGISTRATION_CODE} with your own value):
```
sudo pcoip-register-host --registration-code={REGISTRATION_CODE}
```
If you are using a PCoIP License Server, refer to Licensing the Graphics Agent for macOS for licensing instructions.
Restart the machine.

Installing With the Terminal¶

Download the installer to the machine you'll be using as the PCoIP host.

Contact Teradici for installer

The installer is not publicly available at this time. Contact Teradici for more information.
Open a terminal window.
Run the installer using the following command. Replace {PACKAGE_NAME} with the name of the .pkg file you downloaded:
```
sudo installer -pkg {PACKAGE_NAME}.pkg -target /
```
The installer will return a 0 if successful. A return value of anything other than 0 indicates a failure.
Open the PCoIP Agent application found in /System/Volumes/Data/Applications/PCoIP Agent.app.
You will be prompted to allow Accessibility and Screen Recording permissions. Grant and confirm privacy permissions for both Accessibility and Screen Recording.

Note: No user interface

The PCoIP Agent application launches PCoIP services which continue to run in the background. There is no user interface and no further direct interaction with the application. You do not need to launch PCoIP Agent.app again after installation.
Next, provide the license registration code you received from Teradici.

Important: This step does not apply for PCoIP License Server users

If you are using a local PCoIP License Server, do not follow this step; refer to Licensing the Graphics Agent for macOS.

If you are using Teradici Cloud Licensing, type one of the following commands, depending on whether your host machine is behind a proxy server:
- If you use a proxy server to access the internet, provide this command (replace {REGISTRATION_CODE}, {PROXY_SERVER_ADDRESS}, and {PROXY_PORT_NUMBER} with your own values):
```
sudo pcoip-register-host --registration-code={REGISTRATION_CODE} --proxy-server={PROXY_SERVER_ADDRESS} --proxy-port={PROXY_PORT_NUMBER}
```
- If your system does not use a proxy server, provide this command (replace {REGISTRATION_CODE} with your own value):
```
sudo pcoip-register-host --registration-code={REGISTRATION_CODE}
```
If you are using a PCoIP License Server, refer to Licensing the Graphics Agent for macOS for licensing instructions.
Restart the machine.