Generally, we recommend you uninstall the existing Agent, download the correct Agent from your Cloud or On-Premise Dashboard, and reinstall the Agent.

However, you can edit the Agent configuration file to make the switch too.

1. Run the Command Prompt as an admin:

2. Run the following command in an Administrator Command Prompt to start the Agent service:

3. Open the Agent configuration file (config.cfg). The file is usually located in the following folders:

Hidden Agent:

Revealed Agent:

To switch from a Cloud deployment to an On-Premise deployment: add the following lines to the config.cfg file:

Add the following lines to the config.cfg file:

"Here, <instance_name> is the first part of your dashboard URL. For example, instance=acme.teramind.co. Your cloud instance name can also be found from within the Cloud Dashboard by clicking My Account on the left hand menu and then clicking on the Support Pin tab.

4. Save the file.

5. Restart the Agent using the following command in an Administrator Command Prompt:

If the Agent doesn't come online in the On-Premise Dashboard within a minute, please check your Notifications list (the bell icon in the top right of the Dashboard) to look for any monitoring/license limitations. If a firewall is in used, please verify that the Teramind server's ports are allowed through the firewall. Please refer to the How to check if Teramind IP addresses/hosts and ports are reachable to find the ports needed.
​

Similar to the Windows Hidden Agent, you can edit the same Agent configuration parameters on Mac.

Here are the steps needed:

1. Run the following command on the Mac Terminal to stop the Agent:

2. Open the Mac configuration file (agent.conf) in TextEdit or a similar editor. The file is located in the /usr/local/teramind/agent/etc folder. For example:

To switch from a Cloud deployment to an On-Premise deployment: add the following lines to the agent.conf file:

​To switch from an On-Premise deployment to a Cloud deployment: add the following lines to the agent.conf file:

Here, <instance_name> is the first part of your Dashboard URL. For example, instance=acme.teramind.co.

4. Save the file.

5. Restart the Agent using the following command on the Terminal:

You don't have to modify any configuration files. The user can simply log into the new server by clicking the Advanced link and then entering the new server IP/host in the Server field:

1. Run the following command in a Terminal window to manually create or edit the Agent config file:

2. Enter your Mac's admin password when prompted:

3. Then enter this into the file if you are using a Cloud hosted deployment:

4. For an On-Premise deployment, use the following line instead:

5. Press Ctrl + X and save the file as the current file name.

6. Restart the Hidden Agent using this command in the Terminal window:

The Agent will restart and you should be able to see the computer online on the Dashboard.

1. Follow Steps 1-5 under the Hidden Agent instructions above.

2. Run the following command in the Terminal window: