{"id":13135,"date":"2024-03-15T01:57:33","date_gmt":"2024-03-15T01:57:33","guid":{"rendered":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/"},"modified":"2025-08-05T11:57:13","modified_gmt":"2025-08-05T11:57:13","slug":"how-to-configure-a-containerd-image-repository","status":"publish","type":"post","link":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/","title":{"rendered":"Configure containerd Image Repository"},"content":{"rendered":"

To set up the image repository for containerd, you will need to edit the configuration file of containerd.<\/p>\n

    \n
  1. Open the configuration file for containerd, usually located in \/etc\/containerd\/config.toml.<\/li>\n
  2. Locate the [plugins] section in the configuration file, and if it doesn’t exist, add the following content:<\/li>\n<\/ol>\n
    [plugins]\r\n  [plugins.\"io.containerd.grpc.v1.cri\"]\r\n    [plugins.\"io.containerd.grpc.v1.cri\".registry]\r\n<\/code><\/pre>\n
      \n
    1. [plugins.”io.containerd.grpc.v1.cri”.registry] – There is no other option for running the containerd plugin.<\/li>\n<\/ol>\n
        [plugins.\"io.containerd.grpc.v1.cri\".registry.mirrors]\r\n    [plugins.\"io.containerd.grpc.v1.cri\".registry.mirrors.\"mirror-name\"]\r\n      endpoint = [\"https:\/\/mirror.example.com\"]\r\n<\/code><\/pre>\n
      Replace mirror-name with the name of the mirror repository you prefer, and replace https:\/\/mirror.example.com with the actual address of the mirror repository.<\/p>\n
        \n
      1. Save and close the configuration file.<\/li>\n
      2. Restart the containerd service for the configuration changes to take effect.<\/li>\n<\/ol>\n
        You have successfully configured the image repository for containerd. Now, when you pull images using containerd, it will attempt to retrieve images from the configured image repository.<\/p>\n","protected":false},"excerpt":{"rendered":"
        To set up the image repository for containerd, you will need to edit the configuration file of containerd. Open the configuration file for containerd, usually located in \/etc\/containerd\/config.toml. Locate the [plugins] section in the configuration file, and if it doesn’t exist, add the following content: [plugins] [plugins.”io.containerd.grpc.v1.cri”] [plugins.”io.containerd.grpc.v1.cri”.registry] [plugins.”io.containerd.grpc.v1.cri”.registry] – There is no other option […]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[1],"tags":[17417,708,17193,17415,17416],"class_list":["post-13135","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-config-toml","tag-configuration","tag-containerd","tag-image-repository","tag-registry-setup"],"yoast_head":"\nConfigure containerd Image Repository - Blog - Silicon Cloud<\/title>\n<meta name=\"description\" content=\"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Configure containerd Image Repository\" \/>\n<meta property=\"og:description\" content=\"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog - Silicon Cloud\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-03-15T01:57:33+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-05T11:57:13+00:00\" \/>\n<meta name=\"author\" content=\"Benjamin Taylor\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:site\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Benjamin Taylor\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\"},\"author\":{\"name\":\"Benjamin Taylor\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/ac801fe9549a25960ce48aa2e0a691c9\"},\"headline\":\"Configure containerd Image Repository\",\"datePublished\":\"2024-03-15T01:57:33+00:00\",\"dateModified\":\"2025-08-05T11:57:13+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\"},\"wordCount\":140,\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"keywords\":[\"config.toml\",\"configuration\",\"containerd\",\"image repository\",\"registry setup\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\",\"name\":\"Configure containerd Image Repository - Blog - Silicon Cloud\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\"},\"datePublished\":\"2024-03-15T01:57:33+00:00\",\"dateModified\":\"2025-08-05T11:57:13+00:00\",\"description\":\"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.silicloud.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configure containerd Image Repository\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"name\":\"Silicon Cloud Blog\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\",\"name\":\"Silicon Cloud Blog\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"contentUrl\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"width\":1024,\"height\":1024,\"caption\":\"Silicon Cloud Blog\"},\"image\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\",\"https:\/\/twitter.com\/SiliCloudGlobal\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/ac801fe9549a25960ce48aa2e0a691c9\",\"name\":\"Benjamin Taylor\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ec2e3d3e2d525fd148047c4520ae7c1cdccd1f4b48a1a488422b31f04f345c14?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/ec2e3d3e2d525fd148047c4520ae7c1cdccd1f4b48a1a488422b31f04f345c14?s=96&d=mm&r=g\",\"caption\":\"Benjamin Taylor\"},\"url\":\"https:\/\/www.silicloud.com\/blog\/author\/benjamintaylor\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Configure containerd Image Repository - Blog - Silicon Cloud","description":"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/","og_locale":"en_US","og_type":"article","og_title":"Configure containerd Image Repository","og_description":"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.","og_url":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/","og_site_name":"Blog - Silicon Cloud","article_publisher":"https:\/\/www.facebook.com\/SiliCloudGlobal\/","article_published_time":"2024-03-15T01:57:33+00:00","article_modified_time":"2025-08-05T11:57:13+00:00","author":"Benjamin Taylor","twitter_card":"summary_large_image","twitter_creator":"@SiliCloudGlobal","twitter_site":"@SiliCloudGlobal","twitter_misc":{"Written by":"Benjamin Taylor","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#article","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/"},"author":{"name":"Benjamin Taylor","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/ac801fe9549a25960ce48aa2e0a691c9"},"headline":"Configure containerd Image Repository","datePublished":"2024-03-15T01:57:33+00:00","dateModified":"2025-08-05T11:57:13+00:00","mainEntityOfPage":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/"},"wordCount":140,"publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"keywords":["config.toml","configuration","containerd","image repository","registry setup"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/","url":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/","name":"Configure containerd Image Repository - Blog - Silicon Cloud","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/#website"},"datePublished":"2024-03-15T01:57:33+00:00","dateModified":"2025-08-05T11:57:13+00:00","description":"Learn to configure containerd image repository via config.toml. Step-by-step plugin setup guide.","breadcrumb":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.silicloud.com\/blog\/how-to-configure-a-containerd-image-repository\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.silicloud.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Configure containerd Image Repository"}]},{"@type":"WebSite","@id":"https:\/\/www.silicloud.com\/blog\/#website","url":"https:\/\/www.silicloud.com\/blog\/","name":"Silicon Cloud Blog","description":"","publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.silicloud.com\/blog\/#organization","name":"Silicon Cloud Blog","url":"https:\/\/www.silicloud.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","contentUrl":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","width":1024,"height":1024,"caption":"Silicon Cloud Blog"},"image":{"@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/SiliCloudGlobal\/","https:\/\/twitter.com\/SiliCloudGlobal"]},{"@type":"Person","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/ac801fe9549a25960ce48aa2e0a691c9","name":"Benjamin Taylor","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/ec2e3d3e2d525fd148047c4520ae7c1cdccd1f4b48a1a488422b31f04f345c14?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ec2e3d3e2d525fd148047c4520ae7c1cdccd1f4b48a1a488422b31f04f345c14?s=96&d=mm&r=g","caption":"Benjamin Taylor"},"url":"https:\/\/www.silicloud.com\/blog\/author\/benjamintaylor\/"}]}},"_links":{"self":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13135","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/comments?post=13135"}],"version-history":[{"count":2,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13135\/revisions"}],"predecessor-version":[{"id":157001,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13135\/revisions\/157001"}],"wp:attachment":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/media?parent=13135"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/categories?post=13135"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/tags?post=13135"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}