MochiuWiki : SUSE, EC, PCB

インストール - Rancher Desktop

📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

概要

Rancher Desktopは、デスクトップ上でコンテナ管理、Kubernetesを提供するソフトウェアである。
Mac（Intel、Apple Siliconの両方）、Windows、Linuxで利用できる。

コンテナ管理において、Rancher Desktopでは、コンテナイメージをビルド、プッシュ、プルする機能と、コンテナを実行する機能が提供されている。
これは、Docker CLI（エンジンにMoby / dockerdを選択した場合）または nerdctl（エンジンにcontainerdを選択した場合）の両方で提供される。
nerdctlは、containerdプロジェクトが提供するdocker-compatible CLI for containerdである。

Kubernetesにおいて、Rancher Desktopには、Kubernetesが組み込まれている。
Kubernetesは、軽量ディストリビューションであるk3sによって提供されている。
Rancher Desktopでは、Kubernetesのバージョンを選択して、Kubernetesをリセットしたり、Kubernetesとコンテナランタイム全体をボタン1つでリセットする機能等がある。

RancherとRancher Desktopは、Rancherという名前を共有しているが、それぞれ異なる動作を行う。
Rancherは、Kubernetesクラスタを管理するための強力なソリューションであり、Rancher Desktopは、ローカルのKubernetesとコンテナ管理プラットフォームを提供する。
この2つのソフトウェアは、互いに補完し合っている。

ローカルシステムでRancherを実行する場合は、Rancher DesktopにRancherをインストールすることができる。

Rancher Desktopの詳細を知りたい場合は、Rancher Desktopの公式ドキュメントを参照すること。


Rancher Desktopの動作に必要な条件

Rancher Desktopの動作に必要な条件を、以下に示す。

  • DEBパッケージ、RPMパッケージ、AppImageのいずれかをインストールできる環境
  • 持続的なインターネット接続
  • AMD-VまたはVT-xを搭載したx86_64プロセッサ
  • /dev/kvmへの読み書きアクセス
  • 8[GB]以上のRAM
  • 4CPUs

実行するワークロードによっては、追加のリソースが必要になる場合がある。

GNOMEではシステムトレイをサポートしていないため、Rancher Desktopのトレイアイコンは表示されないことに注意する。


Rancher Desktopのインストール

Rancher DesktopのGithubにアクセスして、Rancher Desktopをダウンロードする。
ダウンロードしたファイルを解凍する。

unzip rancher-desktop-linux-<バージョン>.zip


解凍したファイルを任意のディレクトリに配置する。

Rancher Desktopのデスクトップエントリファイルを作成する。

vi ~/.local/share/applications/Ranchar_Desktop.desktop



 # ~/.local/share/applications/Ranchar_Desktop.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Name=Ranchar Desktop
 GenericName=Ranchar Desktop
 Comment=Kubernetes and Docker Management
 Exec=/<Rancher Desktopのインストールディレクトリ>/rancher-desktop %F
 Icon=/<Rancher Desktopのインストールディレクトリ>/ranchar-desktop.png
 StartupNotify=false
 StartupWMClass=Rancher
 Categories=Development;
 MimeType=;
 Keywords=rancher;kubernetes;docker;


Rancher Desktopを起動すると、~/.bashrcファイル、~/.tcshrcファイル、~/.zshrcファイルの最下行に、以下に示す設定が追記される。

 ### MANAGED BY RANCHER DESKTOP START (DO NOT EDIT)
 export PATH="/home/<ユーザ名>/.rd/bin:$PATH"
 ### MANAGED BY RANCHER DESKTOP END (DO NOT EDIT)


/dev/kvmへのアクセス権を設定する。
一部の環境では、Rancher Desktopに必要な/dev/kvmを使用するための十分な権限がない。
まず、必要な権限があるかどうかを確認する。

[ -r /dev/kvm ] && [ -w /dev/kvm ] || echo 'insufficient privileges'


十分な権限が出力されない場合は、ユーザをkvmグループに追加する必要がある。

sudo usermod -a -G kvm "$USER"


設定を反映させるため、PCを再起動または再ログインする。


Rancher Desktopのアンインストール

まず、Rancher Desktopのインストールディレクトリを削除する。

rm -r <Rancher Desktopのインストールディレクトリ>


次に、Rancher Desktopの設定ファイルおよびディレクトリを削除する。

rm -r ~/.config/"Rancher Desktop"
rm -r ~/.local/share/rancher-desktop
rm -r ~/.rd
rm -r .tcshrc
rm -r ~/.local/share/applications/Ranchar_Desktop.desktop


~/.bashrcファイル、~/.tcshrcファイル、~/.zshrcファイルの最下行にある、以下に示す設定を削除する。

 ### MANAGED BY RANCHER DESKTOP START (DO NOT EDIT)
 export PATH="/home/<ユーザ名>/.rd/bin:$PATH"
 ### MANAGED BY RANCHER DESKTOP END (DO NOT EDIT)



Rancher Desktopの設定

pass

docker login コマンド、nerdctl login コマンドを使用しない場合は、passの設定は不要である。
デフォルトでは、Rancher Desktopは、passを使用して docker login コマンド と nerdctl login コマンド経由で渡された認証情報を安全に保存する。

まず、passをインストールする。

# RHEL
sudo dnf install pass

# SUSE
sudo zypper install password-store


Rancher Desktopをインストールした後、GPGキーを作成する。
これはpassが秘密を保護するために使用する。

gpg --generate-key

# 出力例
8D818FB37A9279E341F01506ED96AD27A40C9C73


上記の出力例が、ユーザのキーIDである。
このキーIDを渡すことで、passを初期化することができる。

pass init <キーID>


passの詳細を知りたい場合は、passの公式Webサイトを参照すること。

Kubernetesの有効 / 無効

このオプションでは、Kubernetesの有効または無効にすることができる。
Kubernetesを無効にすることにより、containerdやdockerdだけを単体で動作させて、リソースの消費を抑えることができる。

初期設定では、Kubernetesは有効化されている。

Kubernetesの有効 / 無効を切り替える場合、[Enable Kubernetes]チェックボックスをオン / オフする。
有効 / 無効に切り替えると、Rancher Desktopは自動的に再起動される。

Kubernetesを無効にしても既存のリソースは削除されずに、Kubernetesを有効に戻すと再び利用可能になる。

Traefikを有効にする

このオプションでは、Traefikを有効または無効にすることができる。
Traefikを無効にすることにより、80番ポートと443番ポートを別のイングレス設定用に解放することができる。

初期設定では、Traefikは有効化されている。

Traefikを有効 / 無効に切り替える場合、[Enable Traefik]チェックボックスをオン / オフする。
有効 / 無効に切り替えた後、Rancher Desktopを手動で再起動する必要がある。

この動作は今後のリリースで変更される予定である。(プロンプトが表示されて、Rancher Desktopが自動的に再起動する)

Traefikを無効にしても既存のリソースは削除されずに、Traefikを有効に戻すと再び利用可能になる。

Traefikポートバインディングアクセス

Rancher Desktopは、デフォルトのイングレスコントローラとしてTraefikを使用している。
Traefik ingressのポートアクセスが制限されているため、Rancher Desktopのデプロイ後に権限エラーに遭遇する可能性がある。

多くのLinuxディストリビューションでは、非スーパーユーザが1024以下のTCPおよびUDPポートをリッスンすることを許可していない。
そのため、Traefikがローカルホストの特権ポートをリッスンできるようにする。

sudo sysctl -w net.ipv4.ip_unprivileged_port_start=80


これにより、80番以上の全てのポートが非特権となり、Traefikは当該ポートに正常にアクセスできるようになる。

再起動後も、この変更をカスタムカーネルパラメータとして設定を維持する場合、上記と同じコマンドを /etc/sysctl.confファイル 内に追記する。


コンテナランタイム

Rancher Desktopのコンテナランタイムを設定することができる。

ユーザは、コンテナの名前空間を提供して、Docker APIとDocker CLIの使用を可能にする nerdctl または dockerd（moby）の使用を提供するcontainerdのオプションがある。
1度に動作できるコンテナランタイムは1つだけであることに注意する。

別のコンテナランタイムに切り替える場合、以下に示す制約がある。

  • Kubernetesの再起動が必要である。
  • 既存のコンテナランタイムを使用してビルド または プルされたワークロードおよびイメージは、切り替え先のコンテナランタイムでは使用できない。


containerdとdockerd(moby)の違い

下表に、Rancher Desktopで選択できるコンテナランタイムの違いを示す。

containerd と dockerd(moby) の比較
ランタイム 特徴
containerd CNCFプロジェクトとして管理されているコンテナランタイムである。
CLIツールとして nerdctl を使用する。
Kubernetesが内部で使用するランタイムと同一であるため、Kubernetes環境との親和性が高い。
lazy-pullingによる高速なイメージ起動 (eStargzイメージ) をサポートしている。
dockerd(moby) Docker APIとDocker CLIを完全にサポートしており、既存のDockerワークフローとの互換性が高い。
CLIツールとして docker を使用する。
docker compose (v2統合) を使用したマルチコンテナ管理に対応している。


CLIツールの対応関係

下表に、コンテナランタイムとCLIツールの対応関係を示す。

コンテナランタイムとCLIツールの対応
コンテナランタイム CLIツール 主なコマンド例
containerd nerdctl nerdctl build, nerdctl push, nerdctl pull, nerdctl run
dockerd(moby) docker docker build, docker push, docker pull
docker run, docker compose


コンテナランタイムの切り替え

コンテナランタイムを切り替える方法を、以下に示す。

CLIから切り替える場合は、rdctl コマンドを使用する。

# containerdに切り替える
rdctl set --container-engine containerd

# dockerd(moby)に切り替える
rdctl set --container-engine moby


GUIから切り替える場合は、Kubernetes設定メニューの[Container Engine]セクションで使用するエンジンを選択する。

ストレージドライバの選択 (Mobyエンジン使用時)

Mobyエンジンを使用している場合、ストレージドライバを選択することができる。

  • classic
    従来型のストレージドライバである。
  • snapshotter
    containerd-snapshotterを使用するストレージドライバである。
    バージョン1.21以降の新規インストールではデフォルトで選択されている。


CLIからストレージドライバを切り替える場合は、以下のコマンドを使用する。

# classicに切り替える
rdctl set --container-engine.moby-storage-driver classic

# snapshotterに切り替える
rdctl set --container-engine.moby-storage-driver snapshotter


ストレージドライバを切り替えると、切り替え前のドライバで作成したイメージはもう一方のドライバからは参照できなくなる。
必要に応じて、イメージの再ビルドまたは再プルを行うこと。


既存のDocker / Podmanとの共存

Rancher Desktopは常にVM内で独自のコンテナランタイムを動作させる。
ホスト上に既にインストール済みのDocker EngineやPodmanを、Rancher Desktopのバックエンドとして直接利用するモードは提供されていない。

Docker Engineとの共存

ホスト上で既にDocker Engine (docker.io / docker-ce) がシステムサービスとして動作している環境でも、Rancher Desktopを使用することは可能である。
ただし、Dockerソケットの競合に注意する必要がある。

ホストのDocker Engineは /var/run/docker.sock を使用する。
Rancher Desktopを管理者権限ありで起動すると、同じパスにソケットを作成しようとするため競合が発生する。

この競合を回避するには、Rancher Desktopを管理者権限なしで起動する。
この場合、Rancher Desktopのソケットは ~/.rd/docker.sock に作成されるため、ホストのDockerソケットと競合しない。

Rancher Desktop側のDockerを使用する場合は、環境変数 DOCKER_HOSTを設定する。

 export DOCKER_HOST=unix://$HOME/.rd/docker.sock


または、docker context コマンドでホストのDockerとRancher DesktopのDockerを切り替えることができる。

# Rancher DesktopのDockerに切り替える
docker context use rancher-desktop

# ホストのDockerに切り替える
docker context use default


Rancher Desktop内のコンテナイメージとホストのDockerイメージは物理的に分離されている。
一方で作成またはプルしたイメージは、もう一方では使用できないため、必要に応じてイメージの再プルまたは再ビルドを行うこと。

Podmanとの共存

Podmanはホストのカーネル上で直接動作するのに対し、Rancher DesktopはVM内でランタイムを動作させるため、技術的な競合は発生しない。
そのため、PodmanとRancher Desktopは問題なく共存できる。

Rancher DesktopにはPodmanをコンテナエンジンとして統合する機能は提供されていない。
Kubernetes開発にはRancher Desktopを使用して、コンテナ管理にはPodmanを使用するというハイブリッド運用も可能である。

共存時の注意点

既存のDocker EngineやPodmanとRancher Desktopを共存させる場合の注意点を以下に示す。

  • Docker Desktopがインストール済みの場合は、Rancher Desktopの導入前に完全にアンインストールすること。
    残存ファイルがソケットやコンテキストの競合を引き起こす可能性がある。

  • Rancher Desktopは ~/.rd/binディレクトリ にCLIツールを配置する。
    ホストのDockerパスと競合しないように、PATHの優先順位に注意すること。

  • docker context list コマンドで現在のコンテキストを確認して、意図したランタイムに接続していることを確認すること。
  • IDEがDockerと連携している場合は、正しいdockerコンテキストが選択されていることを確認すること。



リソースの設定

Rancher Desktopが使用するCPUおよびメモリのリソースを設定することができる。

CPUの割り当て

CPUの割り当て数を変更する場合は、[Preferences] - [Virtual Machine] - [Hardware] - [CPUs]で設定する。
選択可能なCPU数は、ホストシステムが搭載するCPU数に基づいて決定される。

設定値が赤色エリアに表示される場合は、ホストシステムのサービスに影響を与える可能性がある割り当てであることを示す。

メモリの割り当て

メモリの割り当て量を変更する場合は、[Preferences] - [Virtual Machine] - [Hardware] - [Memory]で設定する。
選択可能なメモリ量は、ホストシステムが搭載するメモリ量に基づいて決定される。

設定値が赤色エリアに表示される場合は、ホストシステムのサービスに影響を与える可能性がある割り当てであることを示す。

Windowsでは、デフォルトでホストマシンのメモリの50[%]が割り当てられる。


ボリュームマウント

Rancher Desktopでは、ホストのディレクトリをコンテナにマウントすることができる。

デフォルト共有ディレクトリ

デフォルトで共有されるディレクトリを以下に示す。

  • Linux
    /home/$USER
  • MacOS
    /Users/$USER
  • Linux および MacOS共通
    /tmp/rancher-desktop


マウントタイプ

使用可能なマウントタイプを以下に示す。

  • reverse-sshfs (デフォルト)
    ホスト上でSFTPサーバを実行し、VM内からSSH接続を確立してマウントする方式である。
  • 9p
    QEMU virtio-9p-pciデバイスを使用するマウント方式であり、クロスプラットフォームで利用できる。
  • virtiofs (macOS)
    Apple Virtualization.Frameworkを利用するマウント方式である。


カスタムディレクトリの追加

デフォルト以外のディレクトリをマウントする場合は、[Preferences] - [Virtual Machine] - [Volumes]タブからカスタムディレクトリを追加することができる。

ディレクトリはまずVMにマウントされ、その後コンテナ内にマウントされる。


イメージの管理

Rancher Desktopでは、コンテナイメージのビルド、プル、プッシュ、削除などの操作を行うことができる。

イメージのビルド

イメージをビルドする場合は、使用するコンテナランタイムに応じたコマンドを使用する。

containerdを使用している場合は、以下のコマンドを使用する。

nerdctl build --tag image-name:tag .


dockerd(moby)を使用している場合は、以下のコマンドを使用する。

docker build --tag image-name:tag .


Kubernetesで使用するイメージをビルドする場合は、k8s.io名前空間を指定する。

nerdctl build -n k8s.io -t image-name:tag .


イメージのプル / プッシュ

イメージをプルする場合は、以下のコマンドを使用する。

# docker
docker pull image-name

# nerdctl
nerdctl pull image-name


イメージをプッシュする場合は、以下のコマンドを使用する。

# docker
docker push image-name

# nerdctl
nerdctl push image-name


イメージの一覧表示と削除

イメージを一覧表示する場合は、以下のコマンドを使用する。

# docker
docker image ls

# nerdctl
nerdctl image ls


イメージを削除する場合は、以下のコマンドを使用する。

# docker
docker image rm <image-id>

# nerdctl
nerdctl image rm <image-id>


GUIでの操作

Rancher Desktop UIの [Images] タブから、イメージのビルド、プル/プッシュ、削除を行うことができる。

名前空間の注意点

nerdctlはcontainerdの名前空間を使用しており、デフォルトでは default 名前空間が使用される。
Kubernetesでイメージを利用するには、--namespace k8s.io フラグを指定してビルドまたはプルする必要がある。

また、KubernetesのデプロイメントマニフェストでローカルイメージをKubernetesに使用する場合は、imagePullPolicy: Never を設定する必要がある。


Docker Composeの使用

Rancher Desktop 1.1以降では、Docker Composeが自動的にインストールされる。

dockerd(moby)を使用している場合は docker compose コマンドを使用し、containerdを使用している場合は nerdctl compose コマンドを使用する。

基本的なコマンド

Docker Composeの基本的なコマンドを、以下に示す。

コンテナを起動する場合は、以下のコマンドを使用する。

# docker
docker compose up

# nerdctl
nerdctl compose up


コンテナをバックグラウンドで起動する場合は、以下のコマンドを使用する。

# docker
docker compose up -d

# nerdctl
nerdctl compose up -d


コンテナを停止する場合は、以下のコマンドを使用する。

# docker
docker compose down

# nerdctl
nerdctl compose down


ログを確認する場合は、以下のコマンドを使用する。

# docker
docker compose logs

# nerdctl
nerdctl compose logs


特定のサービスを再起動する場合は、以下のコマンドを使用する。

# docker
docker compose restart SERVICE_NAME

# nerdctl
nerdctl compose restart SERVICE_NAME



ネットワーク設定

ポートフォワーディング

Rancher Desktop 1.9以降では、全てのNodePortが自動的にホストに転送される。

デフォルトでは非特権ポート (ポート番号1024より大きいポート) のみ設定可能である。
管理者権限で実行することにより、特権ポート (ポート番号1024以下) のマッピングも可能になる。

GUIからポートフォワーディングを設定する場合は、[Port Forwarding]タブを使用する。

コマンドでポートを公開する場合は、以下のように指定する。

# nerdctl
nerdctl run -p <ホスト側のポート番号>:<コンテナ側のポート番号> IMAGE

# docker
docker run -p <ホスト側のポート番号>:<コンテナ側のポート番号> IMAGE


VPN環境での使用

VPN環境でRancher Desktopを使用する場合は、実験的なgvisorベースのネットワークスタックを利用することができる。
以下のコマンドで有効化する。

rdctl set --experimental.virtual-machine.networking-tunnel=true


この設定により、VPN背後での動作およびプライベートレジストリへのアクセスに対応できる。

プロキシ設定

プロキシを使用する環境では、[Preferences] - [Proxy]タブからプロキシの有効化または無効化を設定することができる。


kubectl / helmの使用

Rancher Desktopをインストールすると、kubectl、helm、docker または nerdctl が自動的にインストールされる。
これらのツールは、~/.rd/binディレクトリ に配置され、環境変数 PATH への追加は自動的に管理される。

kubectlの基本コマンド

kubectlの基本的なコマンドを、以下に示す。

Podの一覧を表示する場合は、以下のコマンドを使用する。

kubectl get pods


マニフェストファイルをデプロイする場合は、以下のコマンドを使用する。

kubectl apply -f deployment.yaml


ポートフォワーディングを設定する場合は、以下のコマンドを使用する。

kubectl port-forward pod/<POD名> <ホスト側のポート番号>:<コンテナ側のポート番号>


helmの基本コマンド

helmの基本的なコマンドを、以下に示す。

リポジトリを追加する場合は、以下のコマンドを使用する。

helm repo add NAME URL


チャートをインストールする場合は、以下のコマンドを使用する。

helm install RELEASE_NAME CHART


ローカルイメージをKubernetesで使用する方法

ローカルでビルドしたイメージをKubernetesで使用する場合は、以下の手順で行う。

まず、k8s.io 名前空間を指定してイメージをビルドする。

nerdctl build -n k8s.io -t my-app:latest .


次に、デプロイメントマニフェストで imagePullPolicy: Never を指定する。

 apiVersion: apps/v1
 kind: Deployment
 metadata:
    name: my-app
 spec:
    replicas: 1
    selector:
       matchLabels:
          app: my-app
    template:
       metadata:
          labels:
             app: my-app
       spec:
          containers:
          - name: my-app
            image: my-app:latest
            imagePullPolicy: Never



rdctlコマンド

rdctl は、Rancher DesktopのGUI機能へのCLIアクセスを提供するGoバイナリである。
HTTP REST API経由でRancher Desktopと通信するため、rdctl コマンドを使用する際はRancher Desktopアプリケーションが実行中である必要がある。

主要サブコマンド

rdctl の主要なサブコマンドを、以下に示す。

rdctlの主要サブコマンド一覧
サブコマンド 説明
rdctl help ヘルプを表示する。
rdctl version バージョンを表示する。
rdctl api APIエンドポイントへ直接アクセスする。
rdctl list-settings 現在の設定をJSON形式で表示する。
rdctl set 設定を変更する。
rdctl start Rancher Desktopを起動する。
rdctl shutdown Rancher Desktopを安全に終了する。
rdctl shell VM内でインタラクティブシェルを実行する。
rdctl snapshot VMスナップショットを管理する。(create, delete, list, restore, unlock)
rdctl extension install 拡張機能をインストールする。
rdctl extension ls インストール済み拡張機能を一覧表示する。
rdctl extension uninstall 拡張機能をアンインストールする。
rdctl create-profile デプロイメントプロファイルを生成する。
rdctl completion シェル自動補完スクリプトを生成する。


よく使うコマンドパターン

rdctl のよく使うコマンドパターンを以下に示す。

現在の設定を確認する場合は、以下のコマンドを使用する。

rdctl list-settings


複数の設定を一括で変更する場合は、以下のコマンドを使用する。

rdctl set --kubernetes-enabled=false --container-engine docker


Kubernetesを無効化する場合は、以下のコマンドを使用する。

rdctl set --kubernetes-enabled=false


コンテナエンジンを変更する場合は、以下のコマンドを使用する。

# dockerd(moby)に変更
rdctl set --container-engine moby

# containerdに変更
rdctl set --container-engine containerd


APIエンドポイントの概要

下表に、rdctl が通信するAPIエンドポイントの概要を示す。

APIサーバはローカルホストで動的ポートをリッスンしており、Basic認証を使用している。

APIエンドポイント一覧
メソッド エンドポイント 説明
GET /v1/settings 現在の設定を取得する。
PUT /v1/settings 設定を更新する。
GET /v1/about アプリケーション情報を取得する。
GET /v1/backend_state バックエンドの状態を取得する。
PUT /v1/factory_reset ファクトリーリセットを実行する。
POST /v1/diagnostic_checks 診断チェックを実行する。



拡張機能

Rancher Desktop 1.9.0以降で拡張機能を利用することができる。
Docker Desktop Extensionsと互換性があり、既存のDocker拡張機能を使用することも可能である。

拡張機能のインストール

GUIからインストールする場合は、Rancher Desktop UIの[Extensions] - [Catalog]タブで拡張機能を検索してインストールする。

CLIからインストールする場合は、以下のコマンドを使用する。

rdctl extension install <イメージID>:<タグ>

# 例
rdctl extension install docker/logs-explorer-extension:0.2.2


利用可能な拡張機能の例

利用可能な拡張機能の例を、以下に示す。

  • docker/logs-explorer-extension
    コンテナのログを探索・分析するためのツールである。
  • Epinio
    Kubernetesへのアプリケーションデプロイを簡素化するプラットフォームである。
  • Open WebUI
    LLM実行環境を提供するWebUIであり、Ollama統合をサポートしている。
  • SUSE Application Collection
    SUSEが提供するアプリケーションコレクションである。


拡張機能のアンインストール

GUIからアンインストールする場合は、Extensions UIから操作する。

CLIからアンインストールする場合は、以下のコマンドを使用する。

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


拡張機能のアップデートが利用可能な場合は、左メニューの拡張機能アイコンに赤いバブルが表示される。


トラブルシューティング

/dev/kvmの権限エラー

/dev/kvm への読み書き権限が不足している。

まず、以下のコマンドで権限を確認する。

[ -r /dev/kvm ] && [ -w /dev/kvm ] || echo 'insufficient privileges'


権限が不足している場合は、ユーザをkvmグループに追加する。

sudo usermod -a -G kvm "$USER"


設定を反映させるため、PCを再起動または再ログインする。

Dockerソケットの権限不足

Dockerソケットへの書き込み権限が不足している。

解決するには、ユーザをdockerグループに追加する。

sudo usermod -a -G docker "$USER"


設定を反映させるため、PCを再起動または再ログインする。

ストレージドライバの不一致によるイメージ非表示

mobyのclassicとsnapshotter間でイメージが表示されない。

原因は、イメージが非アクティブなストレージドライバ側に存在しているためである。
解決するには、ストレージドライバを統一するか、対象のストレージドライバに合わせてイメージを再ビルドまたは再プルする。

GNOMEでのシステムトレイ問題

GNOMEではシステムトレイをサポートしていないため、Rancher Desktopのトレイアイコンが表示されない。

GNOMEでRancher Desktopを使用する場合は、トレイアイコンが表示されないことを考慮した上で使用すること。

診断機能の活用

Rancher Desktopには[Diagnostics]タブが提供されており、以下の項目を確認することができる。

  • 最小要件の確認
  • 設定ミスの検出
  • ストレージドライバの分析
  • docker contextの確認
  • DOCKER_HOST設定の検証


問題が発生した場合は、まず、[Diagnostics]タブで診断を実行して原因を特定することを推奨する。


「http://mochiuwiki.e2.valueserver.jp/index.php?title=インストール_-_Rancher_Desktop&oldid=14395」から取得