Skip to main content

Agent Unattended Installation

New Agent, versions 1.4.1+ (Windows only)

Installation

To initialize the unattended installation, run the installer with /verysilent switch in the command line.

You can use the additional keys:

  • /login=< login > /password=< password > /pin=< pin code >  to specify your login, password, and pin code.
    Pin-code can be any 4-digit number that will be used instead of a password to access the Agent interface. It can be different for different devices.
    It is mandatory to use the /login, /password, and /pin keys together. If only one of the keys is used, login, password, and pin will be requested via GUI at the first launch.
    Example: /S /login=email@email.com /password=StrongPass /pin=1234
  • /noad key can be used in cases when the Agent needs to be installed in an Active Directory environment as a regular Agent without AD GPO integration.

 Keys from the old Agent will be added in the subsequent releases.

Uninstallation

To initialize the unattended uninstallation, run the uninstaller with /verysilent switch in the command line.


Old Agent

To initialize the unattended installation, run the installer with /S switch in the command line (S must be uppercase).

You can use the additional keys:

  • /login=< login > and /pass=< password > to specify your login and password.
    Example: safedns-agent-setup /S /login=email@email.com /pass=qwerty
    It is mandatory to use the /login and /pass keys together. If only one of the keys is used, both login and password will be requested via GUI at the first launch.
  • /prof=< profile > to specify the filtering policy.
    Example: safedns-agent-setup /S /login=email@email.com /pass=qwerty /prof=My policy
    If the key is not used or the wrong policy is specified, a new policy will be created.
  • /conn=< interface > to specify the network interface which needs to be protected.
    Example: safedns-agent-setup /S /login=email@email.com /pass=qwerty /conn=Wi-Fi
  • /pall to protect all network interfaces.
    If both /conn and /pall are used, then only the former takes action. If neither key is used, only the default network interface will be protected.
  • /dupd turns off automatic checks for the new versions of the Agent.
  • /darun disables automatic startup of the SafeDNS Agent GUI when the system starts (no icon will be shown in the system tray). This switch does not affect the SafeDNS Agent system service.
  • /D=< path > to specify the installation directory (D must be uppercase). It must be the last option used in the command line and must not contain any quotation marks, even if the path contains whitespace characters.
    Example: safedns-agent-setup /S /login=email@email.com /pass=qwerty /D=c:\program files (x86)\SafeDNS Agent
    Only absolute paths are supported.
  • /nogui disables installation of the graphical user interface (GUI). When you use the key, all components will be installed, except for the dns-agent.exe file. You must specify the login and password with this key
 

Don't enclose options containing whitespace characters in quotation marks (i.e. /prof=My policy).


Old Agent, special version for Active Directory

This version supports all commands above and one additional key:

  • /DNS=< IP address > to specify the DNS forwarder.
    Example: safedns-agent-catserver-setup /S /login=email@email.com /pass=qwerty /DNS=192.168.0.1