Skip to content

[README] Tweak Rancher Desktop instructions #4187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
imnasnainaec wants to merge 2 commits into
base: master
Choose a base branch
from
+5 −5
Draft

[README] Tweak Rancher Desktop instructions #4187

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
737a36f
[README] Tweak Rancher Desktop instructions
imnasnainaec Mar 3, 2026
6db1893
Add Linux only
imnasnainaec Mar 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -585,12 +585,12 @@ When _Rancher Desktop_ is first run, you will be prompted to select a few initia
![alt text](docs/images/rancher-desktop-select-runtime.png "Rancher Desktop Select Runtime")

1. Verify that _Enable Kubernetes_ is checked.
2. Select the Kubernetes version marked as _stable, latest_.
2. Select the Kubernetes version marked as _stable_.
3. Select your container runtime, either _containerd_ or _dockerd (moby)_:
- _containerd_ matches what is used on the NUC and uses the `k3s` Kubernetes engine. It requires that you set the
`CONTAINER_CLI` environment variable to `nerdctl` before running the `build.py` script.
- _dockerd_ uses the `k3d` (`k3s` in docker).
4. Select _Automatic_ or _Manual_ path setup.
- _dockerd_ (recommended) uses the `k3d` (`k3s` in docker).
4. (Linux only) Select _Automatic_ or _Manual_ path setup.
5. Click _Accept_.

The _Rancher Desktop_ Main Window will be displayed as it loads the Kubernetes environment. While the page is displayed,
Expand Down Expand Up @@ -780,7 +780,7 @@ otel-opentelemetry-collector-5b5b69557b-zqk5d 1/1 Running 0 1

#### Setup Port Forwarding

_Rancher Desktop only!_
_Only for Rancher Desktop with `containerd`!_

To connect to _The Combine_ user interface on _Rancher Desktop_, you need to setup port forwarding.

Expand All @@ -794,7 +794,7 @@ Note that the port forwarding is not persistent; you need to set it up whenever
#### Connecting to _The Combine_

You can connect to _The Combine_ by entering the URL `https://thecombine.localhost` in the address bar of your web
browser. (`https://thecombine.localhost:<portnumber>` for _Rancher Desktop_)
browser (`https://thecombine.localhost:<portnumber>` for _Rancher Desktop_ with `containerd`).

Notes:

Expand Down
Loading