Install and activate an ACME automation agent

Automating certificate requests on standard hosts, such as web servers, requires that the DigiCert ACME agent be installed and running on each host.

Optionally, you can use a DigiCert sensor as proxy to add fault tolerance options to your host automations. You will be prompted about proxy options during the agent installation process.

To install the agent on more than one server at a time, see Install agent in silent mode.

Before you begin

  • Verify your operating system and web server are supported for automation. See Get started with automation.
  • Verify the system and network requirements for the agent. See System and network requirements.
  • You must have root or administrator permissions to install the agent.
  • You must have CertCentral account credentials with admin or manager role to activate the agent.

Download the ACME agent software

Start by downloading the agent installer package.

To download the agent directly:

To download the agent via CertCentral:

  1. In your CertCentral account, in the left main menu, go to Automation > Manage automation.

  2. Select the Add automation button at top.

  3. Select the Set up an agent option.

  4. Select Yes or No based on how your host will connect to the CertCentral cloud:

    • Yes: If your host will connect to the Internet directly or via a third-party proxy, or via a DigiCert sensor that is already set up. You will proceed directly to the agent download page from here.
    • No: If your host will connect via a DigiCert sensor as proxy, but the sensor is not set up yet. You will be prompted to set up the sensor before proceeding. Return to step 1 when done.
  5. Finally, select Download to download either the Windows or Linux version of the ACME automation agent.

To learn more about using a third-party proxy or DigiCert sensor as proxy, see Use a proxy or sensor with host automations.

Windows: Install and activate the ACME agent

After downloading the Windows version of the ACME automation agent, follow these steps to install and activate it:

  1. Unzip and run the DigiCert ADM Agent executable as an administrator on the certificate host.

  2. Follow the prompts to install the agent. After the agent is installed, the setup wizard immediately starts activation.

  3. Select how the agent will connect to the CertCentral cloud:

    • Direct, no proxy: If the agent will connect directly.
    • My own proxy server: If connecting through a third-party proxy server. You will be prompted to enter the proxy server details.
    • DigiCert sensor as proxy: If connecting through a DigiCert sensor as proxy. You will be prompted to enter the sensor details.
  4. Sign in with your CertCentral credentials to activate this agent.

  5. Select the division that owns or manages this host system. Note: All certificates issued through this agent will be associated with this division.

  6. Assign a custom, easily identifiable name to this agent (optional).

Linux: Install and activate the ACME agent

After downloading the Linux version of the ACME automation agent, follow these steps to install and activate it:

  1. Untar and run start-adm-agent.sh as root on the certificate host.

  2. Follow the prompts to install and activate the agent.

  3. Sign in with your CertCentral credentials to activate this agent.

  4. Select how the agent will connect to the CertCentral cloud:

    • Direct, no proxy: If the agent will connect directly.
    • DigiCert sensor as proxy: If connecting through a DigiCert sensor as proxy. You will be prompted to enter the sensor details.
    • My own proxy server: If connecting through a third-party proxy server. You will be prompted to enter the proxy server details.
  5. Select the division that owns or manages this host system. Note: All certificates issued through this agent will be associated with this division.

  6. Assign a custom, easily identifiable name to this agent (optional).

What's next?