Skip to main content

Dashboard

General

The General tab provides information on communication channels where users can connect with the Rancher Desktop team and community to ask questions, report bugs, or discuss Rancher Desktop in general.

Port Forwarding

To forward a port:

  1. Find the service and click Forward.
  2. Specify a port to use or use the randomly assigned port.
  3. Click the button to confirm your selection.
  4. Optional: click Cancel to remove the port assigned.

Images

The Images tab, allows you to manage the images on your virtual machine.

To manage your images using nerdctl instead, refer to the Images section.

Scanning Images

This feature uses Trivy to scan your images for vulnerabilities and configuration issues.

To scan an image:

  1. From the image list, find the image you want to scan.
  2. Click ⋮ > Scan.
  3. A summary of the vulnerabilities, sorted by the level of severity, are displayed.
  4. Click > to view the details of each vulnerability, including reference links to learn more about the particular vulnerability.

Adding Images

Pulling Images

Use this option to pull images from a registry to your virtual machine.

To pull an image:

  1. Click the + button in the top-right corner.
  2. Click on the Pull tab.
  3. Enter the name of the image to pull.

    Note: By default, images are pulled from Docker Hub which uses the repo/image[:tag] format. To pull from other registries, include the hostname registry.example.com/repo/image[:tag].

  4. Click Pull.

Building Images

Use this option to build an image and add it to your virtual machine.

To build an image:

  1. Click the + button in the top-right corner.
  2. Click on the Build tab.
  3. Enter a name for the image being built. E.g., repo/image, repo/image:tag, registry.example.com/repo/image, or registry.example.com/repo/image:tag.
  4. Click Build.
  5. In the file browser, select the Dockerfile to build an image with.

Troubleshooting

Show Logs

Use this option to open the folder containing all Rancher Desktop log files.

Enable Debug Mode

Enable debug level logging.

Reset Kubernetes

Reset Kubernetes and remove all workloads and configurations. Before the reset occurs, users are presented with a confirmation and the option to also delete container images.

To reset Kubernetes:

  1. Click Reset Kubernetes. A confirmation window appears.
  2. Optional: select whether to also delete container images.
  3. Click Reset to proceed. Kubernetes stops and starts again.

Factory Reset

Remove the cluster and all other Rancher Desktop settings. To continue The initial setup procedure must be done again.

To perform a factory reset:

  1. Click Reset. A confirmation window appears.
  2. Optional: select whether cached Kubernetes images are kept.
  3. Click Factor Reset to proceed. Kubernetes stops and Rancher Desktop closes.
  4. Optional: start Rancher Desktop again.

Preferences

This page allows you to modify the settings of your Rancher Desktop instance.

  1. To access the Preferences, click on the icon in the upper-right corner.
  2. Use the tabs on the left to access different categories of Rancher Desktop preferences.
  3. Update preferences as needed. The preferences available are outlined below.
  4. To apply the updates, click Apply.

Application

Automatic Updates

When an update is available, users are provided a notification and the release notes for the upgrade target. This happens whether automatic updates are enabled or not. If this option is enabled, the update is downloaded and then installed the next time Rancher Desktop is started.

Statistics

This option allows Rancher Desktop to collect information on how you interact with the Rancher Desktop application. Information such as what workloads you run are not collected.

WSL (Windows)

The option to make the Rancher Desktop Kubernetes configuration accessible to any Linux distributions configured for WSL. Once enabled, you can communicate with the Rancher Desktop Kubernetes cluster using tools like kubectl from within the WSL distribution.

With WSL, memory and CPU allocation is configured globally across all Linux distributions. Refer to the WSL documentation for instructions.

Virtual Machine (macOS & Linux)

Memory

The amount of memory to allocate to Rancher Desktop. The selectable range is based on your system. The red area within the range indicates an allocation that may affect system services.

CPUs

The number of CPUs to allocate to Rancher Desktop. The selectable range is based on your system. The red area within the range indicates an allocation that may affect system services.

Container Runtime

Set the container runtime for Rancher Desktop. Users have the option of containerd which provides namespaces for containers and the use of nerdctl or dockerd (moby) which enables the Docker API and the use of the Docker CLI. Only one container runtime will function at a time.

When switching to a different container runtime:

  • Workloads and images that have been built or pulled using the existing container runtime are not available on the container runtime being switched to.

Kubernetes

Enable Kubernetes

This option allows you to enable or disable Kubernetes. By disabling Kubernetes, you can run just containerd or dockerd by itself for reduced resource consumption. By default, Kubernetes is enabled.

To enable/disable Kubernetes, just check/uncheck the Enable Kubernetes checkbox. The app will be restarted when you enable/disable Kubernetes. Disabling Kubernetes will not delete existing resources and they will be available again when you enable Kubernetes again.

Kubernetes Version

This option presents a list of Kubernetes versions that your Rancher Desktop instance can use.

When upgrading:

  • A check is performed to see if the target Kubernetes version is available locally. If not, it downloads the files.
  • Workloads are retained.
  • Images are retained.

When downgrading:

  • Workloads are removed.
  • Images are retained.

To switch versions:

  1. Click the Kubernetes version drop-down menu.
  2. Select the version you want to change to.

Kubernetes Port

Set the port Kubernetes is exposed on. Use this setting to avoid port collisions if multiple instances of K3s are running.

Enable Traefik

This option allows you to enable or disable Traefik. By disabling Traefik, you can free up port 80 and 443 for alternate ingress configuration. By default, Traefik is enabled.

Disabling Traefik will not delete existing resources.