Skip to main content

Introduction to Replicated

This topic provides an introduction to working with the Replicated platform, including key features, supported application installation options, and platform interfaces.


Replicated is a commercial software distribution platform. Independent software vendors (ISVs) can use features of the Replicated platform to distribute modern enterprise software into complex, customer-controlled environments, including on-prem and air gap.

Replicated features are designed to support ISVs in each phase of the commercial software distribution life cycle, as shown below:

software distribution life cycle wheel

View a larger version of this image

The following describes the phases of the software distribution life cycle:

  • Develop: Application design and architecture decisions align with customer needs, and development teams can quickly iterate on new features.
  • Test: Run automated tests in several customer-representative environments as part of continuous integration and continuous delivery (CI/CD) workflows.
  • Release: Use a single, automated release process to share new releases with both on-prem and SaaS customers.
  • License: Licenses are customized to each customer and are easy to issue, manage, and update.
  • Install: Provide unique installation options depending on customers' preferences and experience levels.
  • Report: Make more informed prioritization decisions by collecting adoption and performance data for application instances running in customer environments.
  • Support: Diagnose and resolve support issues quickly.

For more information about the Replicated features that support each of these phases, see the sections below.


The Replicated SDK exposes an in-cluster API that can be developed against to quickly integrate and test core functionality with an application. For example, when the SDK is installed alongside an application in a customer environment, the in-cluster API can be used to send custom metrics from the instance to the Replicated vendor platform.

For more information about using the Replicated SDK, see About the Replicated SDK.


The Replicated compatibility matrix rapidly provisions ephemeral Kubernetes clusters, including multi-node and OpenShift clusters. When integrated into existing CI/CD pipelines for an application, the compatibility matrix can be used to automatically create a variety of customer-representative environments for testing code changes.

For more information, see About the Compatibility Matrix.


Release channels in the Replicated vendor platform allow ISVs to make different application versions available to different customers, without needing to maintain separate code bases. For example, a "Beta" channel can be used to share beta releases of an application with only a certain subset of customers.

For more information about working with channels, see About Channels and Releases.

Additionally, the Replicated proxy service grants proxy access to private application images using the customers' license. This ensures that customers have the right access to images based on the channel they are assigned. For more information about using the proxy registry, see About the Replicated Proxy Service.


Create customers in the Replicated vendor platform to handle licensing for your application in both online and air gap environments. For example:

  • License free trials and different tiers of product plans
  • Create and manage custom license entitlements
  • Automatically restrict access to expired accounts
  • Verify license entitlements both before installation and during runtime

For more information about working with customers and custom license fields, see About Customers.


Applications distributed with Replicated can be installed using the Helm CLI or the Replicated KOTS installer. The Helm CLI supports installation of Helm charts and KOTS supports installation of Helm charts and Kubernetes manifests.

Replicated KOTS is a kubectl plugin and an in-cluster admin console that provides highly successful installations of Helm charts and Kubernetes applications into customer-controlled environments, including on-prem and air gap environments. KOTS also supports installations on VMs or bare metal servers through embedded clusters, which are clusters built from a customized Kubernetes distribution embedded with an application and provisioned in the customer environment at the time of installation.

For more information, see the KOTS documentation.


When installed alongside an application, the Replicated SDK and Replicated KOTS automatically send instance data from the customer environment to the Replicated vendor platform. This instance data includes health and status indicators, adoption metrics, and performance metrics. For more information, see About Instance and Event Data.

ISVs can also set up email and Slack notifications to get alerted of important instance issues or performance trends. For more information, see Configuring Instance Notifications.


Support teams can use Replicated features to more quickly diagnose and resolve application issues. For example:

  • Customize and generate support bundles, which collect and analyze redacted information from the customer's cluster, environment, and application instance. See About Preflights Checks and Support Bundles.
  • Provision customer-representative environments with the compatibility matrix to recreate and diagnose issues. See About the Compatibility Matrix.
  • Get insights into an instance's status by accessing telemetry data, which covers the health of the application, the current application version, and details about the infrastructure and cluster where the application is running. For more information, see Customer Reporting. For more information, see Customer Reporting.

Vendor Platform Interfaces

This section describes the GUI, CLI, and API that software vendors use to interact with the vendor platform.

Vendor Portal

The Replicated vendor portal is the web-based user interface that you can use to configure and manage all of the Replicated features for distributing and managing application releases, supporting your release, viewing customer insights and reporting, and managing teams.

The following shows an example of the Reporting page for a customer:

Customer reporting page showing two active instances

View a larger version of this image

replicated CLI

The replicated command-line interface (CLI) is the CLI for the vendor portal. The replicated CLI can be used to complete tasks programmatically, including all tasks for packaging and managing applications, and managing artifacts such as teams, license files, and so on. For more information, see Installing the replicated CLI.

terminal with replicated CLI commands

Vendor API v3

The Vendor API is the API for the vendor portal. This API can be used to complete tasks programmatically, including all tasks for packaging and managing applications, and managing artifacts such as teams and license files.

For more information, see Using the Vendor API V3.

landing page of the vendor api documentation site