Distributing a Replicated Ship application

A quick overview of how to get started with Replicated Ship.

This content is associated with a legacy version of the Replicated product. For the current Replicated product documentation, see docs.replicated.com.

Replicated Ship is a modern, composable way to define and package any application so that it can be configured, installed, updated and operated by someone with limited knowledge of how the software works. Vendors can distribute proprietary applications with Replicated Ship, for simple and flexible deployment to a variety of destinations, including existing Kubernetes clusters.

When to use Replicated Ship

Replicated Ship is ideal for delivering to customers with highly automated internal IT infrastructure. Replicated Ship offers:

  • Flexible deployments into pre-existing Kubernetes clusters which are already running other third-party or custom applications
  • GitOps workflows, where updates to Replicated Ship applications arrive as pull requests into customers’ code repositories

When to use the Replicated Platform

The Replicated Platform is a better fit for distributing to customers that don’t yet have Kubernetes expertise, and prefer to deploy third party software as virtual appliances on dedicated virtual or physical hosts.


Once an application has been packaged for deployment with Replicated Ship, customers can deploy instances of the application via the Ship Command Line OSS tool, or the Replicated Ship Cloud service. Ship also handles Helm Charts and plain Kubernetes yaml, and can be a complete solution for organizations that wish to integrate third party software into their CI/CD systems, for pull-request-driven deployments.

The process to distribute your application in Replicated consists of the following steps:

  1. Create a new team on the Replicated Vendor Portal.
  2. Prepare the images required by your app. You can either:
    • Tag and push your images to the Replicated Private Registry. Or
    • Select images from a public registry ie Docker Hub. Or
    • Push your images to a third party private registry & provide Replicated with access.
  3. Create your application on the Replicated Vendor Portal. Choose “Kubernetes + Replicated” when asked “How do you want to package your application” on the first page, then choose “Kubernetes + Replicated Ship” on the next page.
  4. Create a release of your application.
  5. Install your application to test.

If you haven’t already reviewed our Delivering a Kubernetes Application with Replicated Ship guide, you should read that before proceeding any further.