> For the complete documentation index, see [llms.txt](https://docs.helmut.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.cloud/the-helmut.cloud-agent/install-the-helmut.cloud-agent-software/macos.md).

# MacOS

* Download the most recent .pkg installer
* As long as the installer is unsigned, open it with a right-click and choose "*Open*" from context-menu
* MacOS will warn you that the installer cannot be verified - choose okay, as we have not signed the installer yet
* Follow along the installation routine and finish installation

The HCloud.app will be installed into the *Applications* folder on your Mac.

## Set privileges for HCloud.app in System Preferences

To allow HCloud.app access to folders inside your users home like Desktop, Downloads or Documents, you will need to set privileges.

Open *System Preferences* via the Apple icon in the upper left corner of your Mac. Navigate to "*Privacy and Security*". Here, you can set granular privileges in *Files and Folders* or add *HCloud.app* to *Full Disc Access*, if your workflow demands it. If you are running HCloud.app unattended, consider to set full disc access to avoid requests blocking your executions.

*You should always consider the apps and the OS users privileges in your environment and set them according to your workflows needs and to internal security guidelines.*