Skip to content

k3d

Run Rancher Lab's k3s in Docker

k3d is a lightweight wrapper to run k3s (Rancher Lab’s minimal Kubernetes distribution) in docker. k3d makes it very easy to create single- and multi- node k3s clusters in docker, e.g. for local development on Kubernetes.

devops

https://k3d.io

arm64 armhf amd64

Installation

1. Add WakeMeOps repository

curl -sSL https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository | sudo bash

2. Install k3d

sudo apt install k3d

Snippets

FROM wakemeops/minideb:bullseye

RUN install_packages \
    k3d=5.6.3*

USER 1001
- name: Install dependencies
  uses: upciti/wakemeops-action@v1
  with:
    packages: |
      k3d=5.6.3*

Download URLs

Version SHA256 Size (KB)
5.6.3 94604481a3e3747bd08f98d720010d03bc474bcfda65031746ade675cb4932b4 5326
5.6.2 c8ca1e9d6aacaac3e75e14c91993e2a579b1888f9b13cc7f1f020c2bf7289e2a 5315
5.6.0 255f9a74116c1c120a8d22740b55d0bc8ce3b0108fc1fc0c331dcc990cb68f54 5156
5.5.2 220b0b5a11099c8dea87bccb0ba9abb6253ecfccc148468c1b324307da911724 5171
5.5.1 00f099016f7f14a9b48c3896468b5f8b7e208c5e23efd2e6e16148aa4aa1f7e8 5031
5.5.0 c1ec09d1dfee202a035b3c9ace512dfca9fa076e0afe2c6be1a3e440a8299244 5029
5.4.9 984e30ac463e87263f83bc3bec3172416b1cf635c3bdcf0e3308dea72931d118 4950
5.4.8 202b22d812d342a4e71bc7d4a01f63b081783dd7e897b52ff4a1d78e9193a9c1 4904
5.4.7 55c89941a8101d0596ebeb1068cb8c42b05dc74fa71a99e136aa0c8348e115dc 4901
5.4.6 776dda6d887063a04ba32876f0ff9114efe7fb511528e0bd80a57edeb93e485c 4877
Version SHA256 Size (KB)
5.6.3 8e1d1239483dbf85c4cc81809b51a6ae27b06e783900024cedef9647302cf847 4553
5.6.2 c4bca9a7db8b6c9b501d6eeec3123c9354d5aee1e2d046ba28e112d936ec5a41 4545
5.6.0 1b8b1eff07c5f6f2caaa94bd1313eeab48ab7394f24a4b36edd888a8410cd51f 4384
5.5.2 77dbe1d09d2d0094f0c2fd01b902f307c9edc784a9d01a209f8ec8577b340b57 4395
5.5.1 43771389a4bf1d6e375304d41defefabdb1d19269c43c64c77b3cecabee14bf1 4280
5.5.0 8691e53409ff8564625d439cb718a1b7ea12dbbda8d10a15e59e20ee512441c7 4280
5.4.9 07fa7404c90c7641c4f6b40612240de9e899d516a4029b3c09062b3362b756b7 4205
5.4.8 90d9a1dda53afce083fad3dd6964138a47532c0a5818981e1063f20a10be0484 4187
5.4.7 3d36d5d84bbf43f7d2cd9806476894730098fa4b7eb463b998386c85e0864d30 4187
5.4.6 0986488a1527da51fd02c56ced781c588cf63d41cb9bf877ad8d625b4337417f 4161
Version SHA256 Size (KB)
5.6.3 53185589c2eb39f68b3326d8931703c1fe03e5b4465930660aaa10a75bb99018 4534
5.6.2 33a8e9469eb870448c78a9dcf71574e263ecc403e7ed9203987b138f2583d4f1 4525
5.6.0 b6db14f3f207f4d26231b4aa5ddd9045483b7a4c0281402815483650f29e5321 4477
5.5.2 53fe0baee66be622bdf79dbf342698c5ac4a4ad7b61fd932f650ef6989a220ec 4491
5.5.1 fba96043bcd266dbd35bd279632ffac61a2aa3c09c83bf03a0e68f644fe36f66 4361
5.5.0 313b5a67d0586b92811c49a986cf6c2cfb31df3ad8b0a86b05b5c4b294060752 4361
5.4.9 6d530575d793cc11f8f221ee69e8420b9a4350483b2e6c7e0024fbb7423f9d81 4285
5.4.8 816083cbd387337cdcddf0f2ef809cf2566fdcc46eda9ff1a5bbfd0f92f8b405 4263
5.4.7 374b9e544104271c6529d6850fb7c09742963de64b794fb1f157d5d7a5e41d40 4263
5.4.6 d627374f60814212ffd0ba01af41a013c39874ac7cb8330bf05ad8ee404ddbfb 4240

Blueprints

Debian packages listed on this page are generated from op2deb YAML blueprints. Blueprints for k3d are versioned here.

Click here to see k3d ops2deb blueprints
https://github.com/upciti/wakemeops/blob/main/blueprints/devops/k3d/ops2deb.yml
- name: k3d
  matrix:
    versions:
      - 5.0.3
      - 5.1.0
  homepage: https://k3d.io
  summary: run Rancher Lab's k3s in Docker
  description: |-
    k3d is a lightweight wrapper to run k3s (Rancher Lab’s minimal Kubernetes
    distribution) in docker. k3d makes it very easy to create single- and multi-
    node k3s clusters in docker, e.g. for local development on Kubernetes.
  fetch: https://github.com/rancher/k3d/releases/download/v{{version}}/k3d-linux-amd64
  script:
    - install -m 755 k3d-linux-amd64 {{src}}/usr/bin/k3d

- name: k3d
  version: 5.2.2
  homepage: https://k3d.io
  summary: run Rancher Lab's k3s in Docker
  description: |-
    k3d is a lightweight wrapper to run k3s (Rancher Lab’s minimal Kubernetes
    distribution) in docker. k3d makes it very easy to create single- and multi-
    node k3s clusters in docker, e.g. for local development on Kubernetes.
  fetch: https://github.com/rancher/k3d/releases/download/v{{version}}/k3d-linux-amd64
  script:
    - mv k3d-linux-amd64 {{src}}/usr/bin/k3d

- name: k3d
  matrix:
    architectures:
      - arm64
      - armhf
      - amd64
    versions:
      - 5.2.2
      - 5.3.0
      - 5.4.0-dev.2
      - 5.4.0
      - 5.4.1
  homepage: https://k3d.io
  summary: run Rancher Lab's k3s in Docker
  description: |-
    k3d is a lightweight wrapper to run k3s (Rancher Lab’s minimal Kubernetes
    distribution) in docker. k3d makes it very easy to create single- and multi-
    node k3s clusters in docker, e.g. for local development on Kubernetes.
  fetch: https://github.com/rancher/k3d/releases/download/v{{version}}/k3d-linux-{{goarch}}
  script:
    - mv k3d-linux-{{goarch}} {{src}}/usr/bin/k3d

- name: k3d
  matrix:
    architectures:
      - amd64
      - arm64
      - armhf
    versions:
      - 5.4.2
      - 5.4.3
      - 5.4.4
      - 5.4.6
      - 5.4.7
      - 5.4.8
      - 5.4.9
      - 5.5.0
      - 5.5.1
      - 5.5.2
      - 5.6.0
      - 5.6.2
      - 5.6.3
  homepage: https://k3d.io
  summary: run Rancher Lab's k3s in Docker
  description: |-
    k3d is a lightweight wrapper to run k3s (Rancher Lab’s minimal Kubernetes
    distribution) in docker. k3d makes it very easy to create single- and multi-
    node k3s clusters in docker, e.g. for local development on Kubernetes.
  fetch: https://github.com/rancher/k3d/releases/download/v{{version}}/k3d-linux-{{goarch}}
  install:
    - k3d-linux-{{goarch}}:/usr/bin/k3d

The blueprint fetch keyword contains a URL template pointing to k3d releases. Downloaded files are locked in a lockfile versioned here.

Click here to see k3d release hashes
https://github.com/upciti/wakemeops/blob/main/blueprints/devops/k3d/ops2deb.lock.yml
- url: https://github.com/rancher/k3d/releases/download/v5.0.3/k3d-linux-amd64
  sha256: 018421fdff567df5df3840e75501a40199501ce6bf25e1f2dd259f74e13519f3
  timestamp: 2021-10-29 22:17:26+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.1.0/k3d-linux-amd64
  sha256: e04cfb3cc04de17c9d4272d0b5506ee5ca1070e36e07519fbe6c00153b993195
  timestamp: 2021-11-10 06:15:40+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.2.2/k3d-linux-amd64
  sha256: 7ddb900e6e50120b65d61568f6af007a82331bf83918608a6a7be8910792faef
  timestamp: 2021-12-17 16:02:55+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.2.2/k3d-linux-arm
  sha256: e3e0c87d419c77295112ff7ccbc8d6228c8738f01b6ec458d76dceeff7710c5c
  timestamp: 2022-01-30 16:22:16+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.2.2/k3d-linux-arm64
  sha256: ccf1dafc1eddfef083375377a52ef0ca269a41c5bc4f0f4d7e11a7c56da08833
  timestamp: 2022-01-30 16:22:16+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.3.0/k3d-linux-amd64
  sha256: b609bf296acb0f0fa5c79f2ff4bdd5901b385833cf469ac503468989e64eb01c
  timestamp: 2022-02-03 16:19:56+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.3.0/k3d-linux-arm
  sha256: 240c1bbd2f7d86653c033d04bb0dd7e1b6f51e1e8e16ead16bafde4106a3ea64
  timestamp: 2022-02-03 16:19:56+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.3.0/k3d-linux-arm64
  sha256: efdeb3ebba60155e21099324012338b076591ec3802a5628d16c66622194ac38
  timestamp: 2022-02-03 16:19:56+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0-dev.2/k3d-linux-amd64
  sha256: 4f10f5ded204dcfe849d131555e40dab340f62c1b0b4159f82d756e5dab2b8e1
  timestamp: 2022-03-24 13:36:26+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0-dev.2/k3d-linux-arm
  sha256: 2b5518c7e9cf7de7e3614cf0ae4006271066e38eed420357c90902a5cf7d0898
  timestamp: 2022-03-24 13:36:26+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0-dev.2/k3d-linux-arm64
  sha256: e52f01614f1ad61befc794c5349d743fce3dfb0d7fa531db8389692d2e26121b
  timestamp: 2022-03-24 13:36:26+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0/k3d-linux-amd64
  sha256: 96c0a1f7aa65dbdc78121b1e6ad24c117fc4128f3c240003366d5e35079d9597
  timestamp: 2022-03-26 13:33:10+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0/k3d-linux-arm
  sha256: 51fe7ea801604791421a64443ec2cb04ee985d025c1cc668e7248e4de1b61f76
  timestamp: 2022-03-26 13:33:10+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.0/k3d-linux-arm64
  sha256: 0321e06c51324b9bb6ea2ab823665289f27d4732606ed3a468b0fafc4051541b
  timestamp: 2022-03-26 13:33:10+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.1/k3d-linux-amd64
  sha256: 50f64747989dc1fcde5db5cb82f8ac132a174b607ca7dfdb13da2f0e509fda11
  timestamp: 2022-03-29 11:20:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.1/k3d-linux-arm
  sha256: 68a3db44493b121e8f48a88ce1976fda78f200a5740ca0fcd7a828cf21a5264a
  timestamp: 2022-03-29 11:20:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.1/k3d-linux-arm64
  sha256: 712ffb338ec1fed6f7c1c8691b79bc80967cc17fef256cd620190d0d7e502052
  timestamp: 2022-03-29 11:20:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.2/k3d-linux-amd64
  sha256: 2dc41edaa43a0149c4d510e5ce074303a09e0c66d106a3e7512887bd1a005a41
  timestamp: 2022-06-05 14:35:27+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.2/k3d-linux-arm
  sha256: a64fd91f302430d3495609716dd5b2d3c8c79c564eb2c8fdf4170a6b65d938cd
  timestamp: 2022-06-05 14:35:27+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.2/k3d-linux-arm64
  sha256: 2dd85b253dd598057f52efd5f6009a60c925c2f974314eb8d98a745bbff580e6
  timestamp: 2022-06-05 14:35:27+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.3/k3d-linux-amd64
  sha256: 8360b69f5f86b3fedfd632ac67b6e8f70af731d4c64df6dbb3d3c67eb723421b
  timestamp: 2022-06-07 20:25:34+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.3/k3d-linux-arm
  sha256: 979ef6f6e1a42701405cbe9440d6fb65ab86599697f136f7f85ba25373d23d53
  timestamp: 2022-06-07 20:25:34+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.3/k3d-linux-arm64
  sha256: f604723614cc2a0a0cdbb69b927320b1634365cd36cd2fefb7375995f947559b
  timestamp: 2022-06-07 20:25:34+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.4/k3d-linux-amd64
  sha256: 786151745379e511bd4dd95d1593241bb2b0a1d91e088573a1a1cb104732a3bd
  timestamp: 2022-07-11 14:47:21+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.4/k3d-linux-arm
  sha256: c1468a8db2737bf9a481926a40076de93cac341ede4d4104df78c830ecdc451e
  timestamp: 2022-07-11 14:47:21+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.4/k3d-linux-arm64
  sha256: 9feb8067e89702947ed17d1e18fd3e445046f4114fbae6f491df8463a72fedfa
  timestamp: 2022-07-11 14:47:21+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.6/k3d-linux-amd64
  sha256: 8075d40c74c97d2642f15f535cb48d6d6e82df143f528833a193d87caac6a176
  timestamp: 2022-08-30 08:55:12+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.6/k3d-linux-arm
  sha256: a807aecef48f32da81b0c65b7269f3f60dea7734385a05d3577425e8cbd72863
  timestamp: 2022-08-30 08:55:12+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.6/k3d-linux-arm64
  sha256: 36db97dfb3f5b56c7cd048924d87abfa5f499c62f524e00e2500fe75f88056ae
  timestamp: 2022-08-30 08:55:12+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.7/k3d-linux-amd64
  sha256: c54218d5bf6cb6e74987bf21f7820483f581b00c49fee11dbdb8c17c7829a025
  timestamp: 2023-02-02 16:20:44+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.7/k3d-linux-arm
  sha256: 0f9c8a313d306e3667f6c716bad6e4e8b28e913af89e153fb184e91cde84f9ee
  timestamp: 2023-02-02 16:20:44+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.7/k3d-linux-arm64
  sha256: c8ceb55ed2ffe2015b915848d0b6eaa72dbc1358270dee4e0c12358c16231d40
  timestamp: 2023-02-02 16:20:44+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.8/k3d-linux-amd64
  sha256: d58bd1b056b88ba4c4cc52b9437c8789209f78ac7c007c441c417f2ccdf3f136
  timestamp: 2023-03-04 22:04:36+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.8/k3d-linux-arm
  sha256: 01f89c300769fe941dd4e77a5e6af457ffe600b371cf9519dd1b09a9420782ac
  timestamp: 2023-03-04 22:04:36+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.8/k3d-linux-arm64
  sha256: 992f3eb4dd7b35cd0991a538d6feb14ec20f364c36d83a1570a823aab0c1f42d
  timestamp: 2023-03-04 22:04:36+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.9/k3d-linux-amd64
  sha256: 5fd6597668e7b09c126eddbafa79f8e0c33695f2974e35f8c9463ef3462f3113
  timestamp: 2023-03-17 09:19:31+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.9/k3d-linux-arm
  sha256: 57c58567ab3aa05ff3e25648846c44452d0e7aee507cbbb610503ef92eb40673
  timestamp: 2023-03-17 09:19:31+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.4.9/k3d-linux-arm64
  sha256: 7d4d9272ee7fa294ecd817e32566fccf514489d5d9556f0cc471decf5ecefa15
  timestamp: 2023-03-17 09:19:31+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.0/k3d-linux-amd64
  sha256: ad7e7ec9a2ca2f1126425760a6102e64167b153bc81566e00d1438e15e084418
  timestamp: 2023-05-17 18:20:46+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.0/k3d-linux-arm
  sha256: 39a6fb7d13995fc2ae1c29a2a3072a24f8cd5d12b8860de30c0e02053da98732
  timestamp: 2023-05-17 18:20:46+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.0/k3d-linux-arm64
  sha256: 50bb6add19c934bb6e91690138448a7f3127059fe301f4ae82aa4d91dd9fb528
  timestamp: 2023-05-17 18:20:46+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.1/k3d-linux-amd64
  sha256: 4849027dc5e835bcce49070af3f4eeeaada81d96bce49a8b89904832a0c3c2c0
  timestamp: 2023-05-20 01:22:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.1/k3d-linux-arm
  sha256: b882af7c10ed2321490676763fdcffebda134b44ae0a71741dc13abc4b8c7013
  timestamp: 2023-05-20 01:22:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.1/k3d-linux-arm64
  sha256: 4a3740fb2bc61fda32b2437c270a5f7dc321ade5e9cb6d932b4b97397538042d
  timestamp: 2023-05-20 01:22:42+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.2/k3d-linux-amd64
  sha256: bd0fac44fd5c6e6962b14d259a2e13229effb6625e4d433aaad6ff76ed2f07b9
  timestamp: 2023-08-03 06:21:19+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.2/k3d-linux-arm
  sha256: 1b538da69b324facdc4f9f5ccbe4a0005c2f9f82d221a14a1a421a564efdbd5c
  timestamp: 2023-08-03 06:21:19+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.5.2/k3d-linux-arm64
  sha256: 2456f2b7db892ae8fb33929543c0a9d672755b8f57b133ea32c83b3aae2f76d5
  timestamp: 2023-08-03 06:21:19+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.0/k3d-linux-amd64
  sha256: c2ca4b90c0c064cd56ae674d586e2003712fe5841748223552e2f8536f741366
  timestamp: 2023-08-21 12:31:38+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.0/k3d-linux-arm
  sha256: 31c40950252cc77a55ca8e771f77b6958adb986a13c40e35f3fbc099a0c5536a
  timestamp: 2023-08-21 12:31:38+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.0/k3d-linux-arm64
  sha256: 00cdc046f51545ef460fd983773cd053f3d4fb9d2d2c916824e7a819b46791a7
  timestamp: 2023-08-21 12:31:38+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.2/k3d-linux-amd64
  sha256: 99b31f7a0244c381e85d18400d62a8e9358ebebe6c65319dbfb94690f2f654db
  timestamp: 2024-04-09 18:06:15+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.2/k3d-linux-arm
  sha256: 92568c05057c63c906203362e1392ee201010bccb7ad6458f5361451d0adf537
  timestamp: 2024-04-09 18:06:15+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.2/k3d-linux-arm64
  sha256: 93fb1f6000f20296f5e6ae8aa8a05b06f1f13adb59ff419ee5bb25db4cbef01f
  timestamp: 2024-04-09 18:06:15+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.3/k3d-linux-amd64
  sha256: 69f434b5a326eddafff6062a1b439d1c7a78a1ee93a91a9f79872cf8e516327d
  timestamp: 2024-04-10 15:05:52+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.3/k3d-linux-arm
  sha256: 4133b1beaca09a07e4ffd42a45a3e314465ea27d1ca3cbc4eb15ea2785b79fa7
  timestamp: 2024-04-10 15:05:52+00:00
- url: https://github.com/rancher/k3d/releases/download/v5.6.3/k3d-linux-arm64
  sha256: 5d2e556e26681474a4aa09b40e2e9880084e0caf63a049b045cb22cc3188de68
  timestamp: 2024-04-10 15:05:52+00:00

Badge

WakeMeOps

[![WakeMeOps](https://docs.wakemeops.com/badges/k3d.svg)](https://docs.wakemeops.com/packages/k3d)
<a href="https://docs.wakemeops.com/packages/k3d">
  <img src="https://docs.wakemeops.com/badges/k3d.svg"/>
</a>
.. image:: https://docs.wakemeops.com/badges/k3d.svg
:target: https://docs.wakemeops.com/packages/k3d