Skip to main content
Sumo Logic

sumo.conf for Legacy Collectors


For legacy Collectors (releases prior to 19.137), the sumo.conf file allows you to pass Collector configuration parameters to Sumo Logic during installation. Once installation is complete, you may delete sumo.conf.

To authenticate Collectors, you must include an access ID and access key. See Access Keys for information on generating and managing access keys.

Creating sumo.conf

After downloading the Collector installer, you'll create the sumo.conf file in a specific directory.

To create sumo.conf:

  1. Using a text editor (or any similar program) create a new file.
  2. Add all of the required parameters and any optional parameters listed in the table in this topic.
  3. Save the file to /etc/sumo.conf (Mac or Linux) or C:\sumo\sumo.conf (Windows).

sumo.conf parameters

The following parameters can be passed to Sumo Logic using sumo.conf

Parameter Description Example Required/Optional


Name used to register the Collector. If no name is specified, the hostname is used. The hostname can be a maximum of 128 characters.

name=FirewallLogs Optional


Access ID generated in the Security page. (See Access Keys.)

accessid=MboxeezMzN8S Required


Access Key generated in the Security page. (See Access Keys.)

accesskey=dBorwTn8TxF8ofounEXnsQ4hPpuqCzw Required


Path to JSON file that contains Source configuration. (See JSON Source Configuration.)
Important: On Windows the path value for "sources=" must be specified with double slashes, \\, as shown in the example.

sources=c:\\sumo sources.json (Windows)



Overrides a Collector's existing Sources to delete all Sources except for the one specified by the sources parameter (above).





When set to true, the Collector will be deleted after 12 hours of inactivity. See Setting a Collector as Ephemeral for more information.

ephemeral=true Optional


Sets the clobber flag; don't include unless you'd like to clobber the Collector.  See Forcing a Collector's Name with Clobber for more information.

clobber=true Optional


Sets the host the Collector uses to connect via a proxy.

proxyHost=hostName Optional


The port number a Collector uses to connect via a proxy. 

proxyPort=portNumber Optional


The user name a Collector uses to connect via a proxy. 

proxyUser=userName Optional


The password associated with the proxyUser setting. 

proxyPassword=password Optional


When using an NTML proxy, the URL used to connect. Optional


When using the Local File Configurtion management method, provides the file path and the name of the JSON file that contains all Source information for the Collector.

syncSources=[file path]/sources.json



Sets URL used to register Collector for data collection API.

url= Optional