SUSE Support

Here When You Need Us

Rancher kubectl shell pod tries to pull an image from external dockerhub instead of pulling from private registry

This document (000021253) is provided subject to the disclaimer at the end of this document.


Rancher 2.6.x, 2.7.x and 2.8.x


- In the Rancher airgap environment, all the images including rancher-shell should get pulled from the default private registry, but there are some situations where few images are getting pulled from the external docker hub instead of the default private registry.


- Verify the rancher "system-default-registry" property is correctly configured using the below command. If it's not, then follow the document [1] and re-configure the registry with the Rancher server.
> kubectl get | grep -i system-default-registry
system-default-registry  <registery URL here>
- If the registry is correctly configured, then verify the 'shell-image' and correct the repo value accordingly using below commands : 
a) kubectl edit settings shell-image

b) modify the value section : 

  customized: false
  default: rancher/shell:v0.1.19
  kind: Setting
    creationTimestamp: "2023-02-12T05:45:41Z"
    generation: 2
    name: shell-image
    resourceVersion: "53446115"
    uid: 39391805-a73a-45b1-b0c4-c336f6326c12
  source: ""
  value: "<add_value_here>"



This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:000021253
  • Creation Date: 27-Mar-2024
  • Modified Date:27-Mar-2024
    • SUSE Rancher

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.