Silent/Automated Installation Guide
  • 21 Aug 2023
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Silent/Automated Installation Guide

  • Dark
    Light
  • PDF

Article Summary

This guide will show you how to perform a silent (non-interactive) installation of ProGet, BuildMaster, or Otter that won't display a user interface or prompt for input. This can be useful for automating your installation and upgrades.

Silent installations use the Inedo Hub's Command Line Interface (CLI), which means that the Inedo Hub must be downloaded and installed first. However, you can perform a silent/scripted installation of the Inedo Hub or even create an offline installation bundle that you can then distribute.

How to Perform a Silent Installation

Before installing an Inedo product silently, you will need to have access to a SQL Server instance. Although the interactive (non-silent) process can install SQL Server Express for you, it's not feasible for the Inedo Hub to do this silently.

Open Command Prompt and use the cd command to navigate to the Inedo Hub installation directory (default is C:\Program Files\Inedo Hub). For example:

 cd C:\Program Files\Inedo Hub

For a basic installation of an Inedo product, you can simply use the install command with the product name and a connection string that points to your SQL Server.

ProductCommand
ProGethub.exe install ProGet --ConnectionString="Data Source=localhost; Integrated Security=True;"
BuildMasterhub.exe install BuildMaster --ConnectionString="Data Source=localhost; Integrated Security=True;"
Otterhub.exe install Otter --ConnectionString="Data Source=localhost; Integrated Security=True;"

Note that you can’t use the install command without the ConnectionString argument, as the Inedo Hub would not know how and where to create and initialize the database schema.

Wait for the installer to finish. Once the installation is finished, you’ll get a message saying that your Inedo product is installed.

How to Upgrade Silently

To silently upgrade an existing Inedo product using the Inedo Hub, follow the same process as a regular install. If a new version is available, it will be downloaded and installed. Note that you only need to specify the ConnectionString if the product's stored connection string does not have permission to modify the database schema.

Performing a Silent Uninstall

If you need to uninstall an Inedo product for whatever reason, you can use the uninstall command. This requires no additional arguments.

ProductCommand
ProGethub.exe uninstall ProGet
BuildMasterhub.exe uninstall BuildMaster
Otterhub.exe uninstall Otter

Once the uninstallation is finished, you will get a confirmation message.

Additional Silent Installation Options

It's possible to customize your Inedo product installation during the install stage by adding additional arguments to the command line when setting up.

Example: Specifying a License Key

For example, the following command will install ProGet with an existing license key so that you don't have to manually enter it later.

hub.exe install ProGet --ConnectionString="Data Source=localhost; Integrated Security=True;" LicenseKey=«your-license-key»

Example: Installing to a Specific Version

By default, the Silent Install method will always download and install the newest version of the specified Inedo product. If you need to install a specific version, you can add the desired version number to the install string.

For example, to install ProGet 5.2.3 using the upgrade process:

hub.exe install ProGet:5.2.3 --IsUpgrade=true

Using Other Installation Arguments

Other common customization options include the ability to use IIS (--UseIIS), and specifying a custom path for Inedo extensions (--ExtensionsPath=«custom-extensions-path»)

A full list of features that can be customized during a silent instalation is available on our Inedo Hub CLI guide.

Scripted Installation of Inedo Hub

The Inedo Hub may be installed manually by downloading the contents of the latest DesktopHub package as a zip file, and then extracting it to a target directory (such as c:\InedoHub).

Note that this process will not register the program as installed with Windows, nor will it add an icon to use the InedoHub in the start menu.

Example: PowerShell to Fully Script Installation

Following is an example script that will download the Inedo Hub, extract it to c:\InedoHub, and then run a silent installation of ProGet 5.2.3.

# create working directories
mkdir C:\InedoHub
cd C:\InedoHub

# download and extract file to working directory
Invoke-WebRequest "https://proget.inedo.com/upack/Products/download/InedoReleases/DesktopHub?contentOnly=zip&latest" -OutFile C:\InedoHub\InedoHub.zip
Expand-Archive -Path InedoHub.zip -DestinationPath C:\InedoHub

# perform silent installation
hub.exe install ProGet:5.2.3 --ConnectionString="Data Source=localhost; Integrated Security=True;"

Was this article helpful?