Skip to main content
System StatusContact Support Agility Community

Core Setup Command Line

Use these commands to install Agility Core from the command line.

Setup [action] [instance] [options]


Action Description


Install a new instance


Repair (or upgrade) an existing instance


Uninstall an existing instance


The instance name cannot contain spaces or special characters. For a New Instance, you will enter the name that you want to call the instance. This will be part of the URL, so make sure you select an appropriate name for your new instance.

For an Upgrade, the easiest way to see what the instance name needs to be in the command line is to run the installer in Wizard mode (double-click the installer executable), select Upgrade, and look at the list of Agility instances listed on the "Select from these installed instances" dialog. The name you need to use in the command line is the full name that shows up on the "Select from...." dialog, minus the version number in parentheses. This also applied to command line Uninstalls.


Options begin with a dash or slash. Values are supplied to an option following a colon or equal-sign.  For example:


These options are available:

Option Description


Suppresses the wizard and message boxes. A value of 2 also suppresses the progress dialog.


Choose a different name for the Setup log. The default is setup.log.


Choose the methodology. The default is Team for Team Edition, or XP for other editions.


Choose the website to which to install this instance. In hosted production: IIS://localhost/W3SVC/100/ROOT

-DbServer:<server> -DbName:<database> -DbUser:<username> -DbPassword:<password>

Configure and provide access to SQL Server for Setup, and this instance.

<server> defaults to "(local)"
<database> defaults to instance name

Without <username> and <password>, Setup uses integrated authentication to access SQL Server.


Choose the authentication mode. The default is V1.

-SigningKey:<32 bytes in HEX>

Set the encryption key used to sign the authentication Tickets held in cookies and OAuth2 grant records. Otherwise read from registry or randomly generated.


(In AuthMode IIS) Choose the Windows account name that will be associated with the first admin (a.k.a. "Admin 20")


Prevents Setup from creating its own secure-user to access the database, and lets a DBA manage the SQL logins.

See Installing and configuring Agility to use an Existing Sql Server User.


Set the client-friendly scheme and host (and port) for generating absolute URLs back into the application. Used for putting links into emails.

For example:

-SmtpHostName:<host> -SmtpFromAddress:<email>

Configures and enables SMTP.


Forces the execution of database scripts, even if the thumbprint indicates they are not needed.


When uninstalling this instance, delete the data also. The default is to not delete.