> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idemeum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install agent

> Install idemeum agent on Windows or macOS.

You can install idemeum agent by executing an installation command using PowerShell or macOS terminal. For mass install guides please check our integrations page.

## Agent installation

<Tabs>
  <Tab title="Windows">
    ### Installation

    <Steps>
      <Step title="Obtain PowerShell script">
        Navigate to your idemeum admin portal, click `Install new agent` button and copy the installation script for Windows.
      </Step>

      <Step title="Execute script using PowerShell">
        <Warning>
          Make sure you execute the script with PowerShel Administrator privileges.
        </Warning>

        Open PowerShell and execute the installation script with Administrator privileges. Idemeum will install all required prerequisites before installing the agent. No restart is required after successful installation.
      </Step>
    </Steps>

    ### Command-line arguments

    You can pass additional command-line arguments to the installation script:

    <ParamField path="- restartAfterInstall" type="'true' | 'false'">
      Restart is not required, however you can still trigger the restart after the successful installation by passing `true` as an option.
    </ParamField>

    <ParamField path="- appControlMode" type="'disabled' | 'audit' | 'rules'">
      By default when the agent is installed it operates in `disabled` mode. You can pass the mode which you want to apply at installation time.
    </ParamField>

    <ParamField path="- version" type="'2.5.1'">
      Pass the desktop version that you want to install. By default the latest version will be installed. You need to pass the version with '', for instance '2.5.1'.
    </ParamField>
  </Tab>

  <Tab title="macOS">
    ### Prerequisites

    <Note>
      When installing macOS idemeum agent you will need to enable security permissions, including Security Extension, Full Disk Access, and Accessibility. We recommend deploying production agents with MDM profile to make sure permissions stay enabled after agent updates.
    </Note>

    ### Installation

    <Warning>
      While you can install macOS agent without the profile and enable the permissions manually, we recommend to deploy profiles for production deployments.
    </Warning>

    <Steps>
      <Step title="Download macOS profile">
        Navigate to your idemeum portal, click `Install idemeum agent`, choose `macOS` and download the idemeum profile.
      </Step>

      <Step title="Deploy profile with your MDM">
        Push the idemeum profile to macOS workstations where idemeum agent will be deployed. Profile automatically enables all required settings.
      </Step>

      <Step title="Obtain bash installation script">
        Navigate to your idemeum portal, click `Install idemeum agent`, choose `macOS` and copy the script for macOS.
      </Step>

      <Step title="Deploy bash script">
        Now you can deploy the idemeum script to your workstations using the deployment tool of your choice (MDM, RMM, etc.). No restart is required after installation.
      </Step>
    </Steps>

    ### Command-line arguments

    You can pass additional command-line arguments to the installation script:

    <ParamField path="- appControlMode" type="'disabled' | 'audit' | 'rules'">
      By default when the agent is installed it operates in `disabled` mode. You can pass the mode which you want to apply at installation time.
    </ParamField>
  </Tab>
</Tabs>