Arctic Wolf Agent Installation on Linux - Multiple Endpoints

Updated Feb 22, 2024

Install Arctic Wolf Agent on multiple Linux endpoints

You can install Arctic Wolf® Agent on multiple endpoints in your organization using a package manager.


Before you begin


  1. Download the Agent installer:

    1. Sign in to the Arctic Wolf Unified Portal.
    2. Click > Downloads.
    3. In the Arctic Wolf Agent section, in the Operating System list, select the required operating system.
    4. Click Download Agent.
  2. Make sure that the Agent zip file is extracted into the arcticwolfagent_<version>.<deb|rpm> package file and the customer.json file.


    • Do not edit the customer.json file. Editing this file causes installation errors.
    • Do not save the Agent installer or customer.json to a location with public access. Keep the customer.json file confidential.
  3. Based on your OS and preferred package manager, run one of these commands:

    • Ubuntu using APT:
      sudo DEBIAN_FRONTEND=noninteractive AWN_CUSTOMER_JSON=/tmp/customer.json apt install /tmp/arcticwolfagent_<version>.deb
    • CentOS, Red Hat, or Amazon Linux:
      • YUM (preferred):
        sudo AWN_CUSTOMER_JSON=/tmp/customer.json yum install arcticwolfagent_<version>.rpm
      • Zypper:
        sudo AWN_CUSTOMER_JSON=/tmp/customer.json zypper install --allow-unsigned-rpm arcticwolfagent_<version>.rpm
      • DNF:
        sudo AWN_CUSTOMER_JSON=/tmp/customer.json dnf install arcticwolfagent_<version>.rpm


    • You must save customer.json in the /tmp folder.
    • Use an absolute path to customer.json and verify that it is correct. If any errors occur pertaining to the customer.json file, see Arctic Wolf Agent Troubleshooting.
    • You can install Agent with any package manager on CentOS, Red Hat, or Amazon Linux, but only YUM has been tested.
    • Agent only performs automated tests with YUM, DNF, and Zypper.
  4. When the command line prompts you, install the Linux utilities that are required for your operating system if they are not installed:

    Operating systems Required Linux utilities
    • Debian
    • Linux Mint
    • Ubuntu
    • adduser
    • bsdutils
    • coreutils
    • debconf
    • debianutils
    • dnsutils
    • hostname
    • iproute2
    • iptables
    • libc6 (>= 2.7)
    • lsb-release
    • lshw
    • net-tools
    • network-manager
    • procps
    • systemd
    • usbutils
    • Amazon Linux 2
    • CentOS
    • Oracle Linux
    • Red Hat
    • chkconfig
    • coreutils
    • hostname
    • iptables
    • lshw
    • net-tools
    • systemd
    • which
    Note: Red Hat, CentOS, and other RPM-based Linux distributions do not require the net-tools utility.
  5. Contact your Arctic Wolf Customer Success Manager or your Concierge Security® Team (CST) at to confirm that Agent data is reaching Arctic Wolf.

See also