For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prerequisites

DeployR integrates with StifleR and relies on several supporting components, including database services, deployment tools, and runtime dependencies. Proper configuration of these elements is required to ensure reliable operation and deployment workflows.

Before installing DeployR, ensure that the following prerequisites are in place:

FQDN

The server must have a valid FQDN DNS entry.

  • Example: deployr.company.local

This FQDN is used for alll Service URLs and Certificate bindings.

Ports

These ports are inbound to DeployR server. (depending on the options you have installed)

  • 7281 TCP: DeployR for secure communications from the clients

Additional port information can be found for the corrisponding compononts you're using with DeployR:

StifleR Components

  • StifleR Server 3.1

  • StifleR Dashboard 3.1

StifleR supports Windows Server 2019 or later, and requires .NET Framework 4.8 to be installed, along with appropriate firewall configuration and TLS/SSL certificates.

Refer to StifleR Server and StifleR Dashboard for installation instructions.

Note: Ensure that the StifleR Dashboard can be accessed from the DeployR server, and you can successfully authenticate using Windows credentials. If this works from a remote computer but results in an authentication loop from the DeployR server, this could be an issue with a Windows LSA loopback setting. See https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/accessing-server-locally-with-fqdn-cname-alias-denied for more information. This is a common issue when using a CNAME alias for accessing the server, but can occur in other scenarios as well.

DeployR Server Requirements

DeployR should typically be installed on the same server as StifleR, and requires additional components to be installed and configured.

Database

Supported version of Microsoft SQL Server (Express edition or higher)

Used for:

  • Metadata storage

  • Deployment progress tracking

Windows features

BranchCache (optional Windows feature)

.NET Components

The latest .NET 10.0 components, available for download from Microsoft

  • .NET Runtime 10.0.8

  • .NET Desktop Runtime 10.0.8

  • ASP.NET Core Runtime 10.0.8

PowerShell

The latest PowerShell 7.6 release, available for download from Microsoft

PowerShell 7.6.2 for full compatibility.

Windows ADK

The Microsoft Assessment & Deployment Toolkit (ADK) for Windows 11

  • Recommend 24H2 Dec Release: 10.1.26100.2454

  • ADK version 10.1.28000.1 is not recommended due to issues with driver integration.

Certificates

TLS/SSL certificates are required for secure communication

Service Account

By default, DeployR runs under the LocalSystem account . A custom service account can be used if required

Optional: Linux Deployment Support

For Linux bare metal deployments:

  • Windows Subsystem for Linux (WSL) is required

    • The server must support:

      • Hardware-assisted virtualization

      • Or nested virtualization (for virtual machines)

Automation Scripts

Scripts to automatically install and configure prerequisites are available on GitHub:

Last updated