Setting Up an Agent Using System Proxy

Purpose

This document describes how to set up an agent behind a proxy.

Introduction

In environments where machines must route external traffic through a proxy, Outpost24 agents are not able to enroll, fetch configurations, or send results unless they are configured to use that proxy. The system proxy setup lets you embed the HTTPS_PROXY setting into the agent’s operating-system environment—whether on Linux, Windows or macOS—so that all agent communications pass through the proxy without manual redirection. This ensures agents work correctly behind firewalls or in segmented networks, preserving security while maintaining full functionality.

Configuration

Linux

Edit the /etc/sysconfig/o24-agent file to add a block to specify and HTTPS_PROXY directive.

HTTPS_PROXY="http://<PROXY_IP>:<PROXY_PORT>"

Windows

In the Start menu:

1. Open Settings.

2. Go to About.

3. Click on Advanced System Settings.

4. Click on Environment Variables.

5. Under System Variables click New.

6. Under New System Variable, fill in the new Variable Name and Variable Value.
   

   

7. Click OK to add each new variable.

macOS

Edit the /Library/LaunchDaemons/com.outpost24.agent.plist file to add a block to specify and Launch Service Environment key.

<key>LSEnvironment</key>
<dict>
      <key>HTTPS_PROXY</key>
      <string>http://<PROXY-IP>:<PROXY-PORT></string>
</dict>

You can also use standard agent-settings.yml file extracted from another pages which allows you to not make a curl call to get the enrollment configuration.

_Copyright

_{© 2025 Outpost24® All rights reserved. This document may only be redistributed unedited and unaltered. This document may be cited and referenced only if clearly crediting Outpost24® and this document as the source. Any other reproduction and redistribution in print or electronically is strictly prohibited without explicit permission.}

_Trademark

_{Outpost24® and OUTSCAN™ are trademarks of Outpost24® and its affiliated companies. All other brand names, product names or trademarks belong to their respective owners.}