Installer command-line options for Mac
On macOS Monterey 12.4 or later, you can't unzip the installer in the documents
or downloads
directories or on the desktop. It will fail to install. You must unzip the installer somewhere else, we recommend the home directory, /users/<username>/
.
On macOS Big Sur 11 you must unzip the installer in the home directory, /users/<username>/
.
Command-line options
Some options may not be available for all customers yet.
The Sophos Central Endpoint installer for Mac supports the following command-line options.
Quiet
Runs the installer without displaying the user interface.
--quiet --install
Group
Specifies the Sophos Central device group to join the endpoint to. You can also use this option to add devices to a subgroup. You must use \
for any groups that have spaces in their names.
--devicegroup <Central group\>
--devicegroup <Central group\>\\<Central subgroup\>
--devicegroup <Central group\>\\<Central subgroup\>\\<Central subgroup\>
Example
--devicegroup Organization\\Group\ with\ space\\Subgroup
Message relays
Specifies a list of message relays to use.
--messagerelays <space-separated message relay list of IPs including the port\>
Trailing argument
The IP address of the message relay must be specified along with port 8190.
Example
--messagerelays IPADDRESS:8190 IPADDRESS:8190
Proxy address
Specifies a custom proxy to use.
--proxyaddress <custom proxy address\>
Trailing argument
URL without protocol (will use HTTPS)
Proxy port
Specifies a port that the proxy uses.
--proxyport <proxy port\>
Trailing argument
Port for the proxy.
Proxy username
If a custom proxy has been specified, set the username with this option.
--proxyusername <custom proxy user name\>
Trailing argument
The username of the proxy.
Proxy password
If a custom proxy and username have been specified, set the password with this option.
--proxypassword <custom proxy password\>
Trailing argument
The password for the proxy.
Computer name override
Overrides the name of the computer to be used in Sophos Central. Don't use quotes around the computer name. You can only use this option for a new installation.
--computernameoverride <override for computer name\>
Trailing argument
Custom computer name.
Domain name override
Overrides the domain name of the computer to be used in Sophos Central. You can only use this option for a new installation.
--domainnameoverride <override for domain\>
Trailing argument
Custom domain name.
Preferred domain name for usernames in Sophos Central
Sets the client to send usernames as domain\\username
instead of machine\\username
. You can only use this option for a new installation.
--mcsPreferredDomainName
Registration server
Specifies the MCS server to connect to.
--mgmtserver <registration server URL\>
Trailing argument
MCS server URL.
Customer token
Specifies the token of the Sophos Central customer to associate the endpoint with.
--customertoken <the customer token\>
Trailing argument
A UUID which maps to a customer.
Products to install
Specifies a list of products to install. If you specify a product that you don't have a license for, then it isn't installed.
--products <space separated list of products to install\>
Trailing argument
Space-separated list of products to install.
Available options are antivirus
, intercept
, mdr
, xdr
, deviceEncryption
or all
.
Note
The Mac installer is aware of all the message relays and update caches when the installation is downloaded. Changes to caches and relays mean that you need to download a new installation. You can specify relays using the command line as well.
For more help with the installer, see Installer precheck messages.
xdr
Restriction
You can only install xdr
on Macs running macOS Big Sur 11 or later.
If you install xdr
only we won't install anti-malware protection. You must have third-party protection installed to protect your devices.
Mac examples
-
Install Sophos Anti-Virus and Intercept X without user interaction:
sudo ./Sophos\ Installer.app/Contents/MacOS/Sophos\ Installer --products antivirus intercept --quiet
-
Install using a proxy:
sudo ./Sophos\ Installer.app/Contents/MacOS/Sophos\ Installer --proxyaddress <ProxyIP/FQDN> --proxyport <Port>
-
Install using a message relay:
sudo ./Sophos\ Installer.app/Contents/MacOS/Sophos\ Installer --messagerelays 192.168.10.100:8190