Installing and Uninstalling Rancher Desktop Extensions

The Extensions feature introduced in the v1.9.0-tech-preview release enables you to use Docker Desktop Extensions within Rancher Desktop. The feature helps you extend Rancher Desktop’s functionality to meet your additional needs. This guide will demonstrate how to install and uninstall Docker extensions in Rancher Desktop.

Prerequisites

Rancher Desktop Extensions are available as part of release v1.9.0-tech-preview or later.

Installing Extensions

There are two ways in which you can install extensions, a method using the UI and another using the rdctl extension install command.

  • Windows
  • macOS
  • Linux

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. Here you can search through extensions available for use which can be downloaded and installed using the Install button.

Installing and Uninstalling Rancher Desktop Extensions - 图1

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to install extensions. Please use the command below to install extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图2note

The use of the <tag> parameter is optional.

  1. rdctl extension install <image-id>:<tag>

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. Here you can search through extensions available for use which can be downloaded and installed using the Install button.

Installing and Uninstalling Rancher Desktop Extensions - 图3

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to install extensions. Please use the command below to install extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图4note

The use of the <tag> parameter is optional.

  1. rdctl extension install <image-id>:<tag>

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. Here you can search through extensions available for use which can be downloaded and installed using the Install button.

Installing and Uninstalling Rancher Desktop Extensions - 图5

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to install extensions. Please use the command below to install extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图6note

The use of the <tag> parameter is optional.

  1. rdctl extension install <image-id>:<tag>

Uninstalling Extensions

Additionally, there are two ways in which you can uninstall extensions, a method using the UI and another using the rdctl extension uninstall command.

  • Windows
  • macOS
  • Linux

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. On this view, you can search through the available extensions, and uninstall the already installed extensions. Extensions can also be uninstalled from the Installed tab by clicking the Remove button.

  • Catalog
  • Installed

Installing and Uninstalling Rancher Desktop Extensions - 图7

Installing and Uninstalling Rancher Desktop Extensions - 图8

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to uninstall extensions. Please use the command below to uninstall extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图9note

The use of the <tag> parameter is optional.

  1. rdctl extension uninstall <image-id>:<tag>

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. On this view, you can search through the available extensions, and uninstall the already installed extensions. Extensions can also be uninstalled from the Installed tab by clicking the Remove button.

  • Catalog
  • Installed

Installing and Uninstalling Rancher Desktop Extensions - 图10

Installing and Uninstalling Rancher Desktop Extensions - 图11

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to uninstall extensions. Please use the command below to uninstall extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图12note

The use of the <tag> parameter is optional.

  1. rdctl extension uninstall <image-id>:<tag>

Using the UI

Click Extensions from the main UI to navigate to the Catalog tab. On this view, you can search through the available extensions, and uninstall the already installed extensions. Extensions can also be uninstalled from the Installed tab by clicking the Remove button.

  • Catalog
  • Installed

Installing and Uninstalling Rancher Desktop Extensions - 图13

Installing and Uninstalling Rancher Desktop Extensions - 图14

Using the Command Line

We have also extended the rdctl command line in the v1.9.0-tech-preview release to uninstall extensions. Please use the command below to uninstall extensions:

Installing and Uninstalling Rancher Desktop Extensions - 图15note

The use of the <tag> parameter is optional.

  1. rdctl extension uninstall <image-id>:<tag>