{"id":13489991,"url":"https://github.com/cnrancher/autok3s","last_synced_at":"2026-02-11T08:21:45.674Z","repository":{"id":36981780,"uuid":"283404701","full_name":"cnrancher/autok3s","owner":"cnrancher","description":"Run K3s Everywhere","archived":false,"fork":false,"pushed_at":"2024-10-28T09:22:15.000Z","size":77381,"stargazers_count":789,"open_issues_count":44,"forks_count":78,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-11-18T02:47:46.927Z","etag":null,"topics":["alibaba","automation","aws","bootstrap-k3s","google","harvester","k3d","k3s","k3s-cluster","k8s","kubernetes","rancher","tencent"],"latest_commit_sha":null,"homepage":"https://www.suse.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cnrancher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-29T05:13:34.000Z","updated_at":"2024-11-15T06:52:59.000Z","dependencies_parsed_at":"2023-02-18T05:15:52.869Z","dependency_job_id":"aa89b82a-e0ac-4005-a3b8-0d6257038f69","html_url":"https://github.com/cnrancher/autok3s","commit_stats":null,"previous_names":[],"tags_count":71,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnrancher%2Fautok3s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnrancher%2Fautok3s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnrancher%2Fautok3s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnrancher%2Fautok3s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cnrancher","download_url":"https://codeload.github.com/cnrancher/autok3s/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245978200,"owners_count":20703675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alibaba","automation","aws","bootstrap-k3s","google","harvester","k3d","k3s","k3s-cluster","k8s","kubernetes","rancher","tencent"],"created_at":"2024-07-31T19:00:39.049Z","updated_at":"2026-02-11T08:21:40.631Z","avatar_url":"https://github.com/cnrancher.png","language":"Go","funding_links":[],"categories":["Kubernetes","Go"],"sub_categories":["Utils"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eAutoK3s\u003c/h1\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://drone-pandaria.cnrancher.com/cnrancher/pandaria\"\u003e\u003cimg alt=\"Build Status\" src=\"http://drone-pandaria.cnrancher.com/api/badges/cnrancher/autok3s/status.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://goreportcard.com/report/github.com/cnrancher/autok3s\"\u003e\u003cimg alt=\"Go Report Card\" src=\"https://goreportcard.com/badge/github.com/cnrancher/autok3s\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/cnrancher/autok3s/releases\"\u003e\u003cimg alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/cnrancher/autok3s?color=default\u0026label=release\u0026logo=github\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/cnrancher/autok3s/releases\"\u003e\u003cimg alt=\"GitHub release (latest by date including pre-releases)\" src=\"https://img.shields.io/github/v/release/cnrancher/autok3s?include_prereleases\u0026label=pre-release\u0026logo=github\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\n## What is AutoK3s\n\nEnglish / [简体中文](docs/i18n/zh_cn/README.md)\n\n[K3s](https://k3s.io/) is a Lightweight Kubernetes which is great for Edge, IoT, CI, Development, ARM and so on.\n\nAutoK3s is a lightweight tool for simplifying the cluster management of K3s, it can help you **Run K3s Everywhere**.\n\n\u003c!-- toc --\u003e\n\n- [Key Features](#key-features)\n- [Providers](#providers)\n- [Quick Start (tl;dr)](#quick-start-tldr)\n- [Demo Video](#demo-video)\n- [Developers' Guide](#developers-guide)\n- [Source Code](#source-code)\n- [License](#license)\n\n\u003c!-- /toc --\u003e\n\n## Key Features\n\n- Flexible installation options, like K3s cluster HA and datastore(embedded etcd, RDS, SQLite, etc.).\n- Simplify operations by UI dashboard.\n- [Airgap](docs/i18n/en_us/airgap/README.md) K3s package management and installation.\n- [Add-on](docs/i18n/en_us/add-on/README.md) streamlines the management and deployment of plugins, seamlessly integrating applications into K3s clusters.\n\n## Providers\n\nNow supports the following providers, we encourage submitting PR contribution for more providers:\n\n- [aws](docs/i18n/en_us/aws/README.md) - Bootstrap K3s onto Amazon EC2\n- [google](docs/i18n/en_us/google/README.md) - Bootstrap K3s onto Google Compute Engine\n- [alibaba](docs/i18n/en_us/alibaba/README.md) - Bootstrap K3s onto Alibaba ECS\n- [tencent](docs/i18n/en_us/tencent/README.md) - Bootstrap K3s onto Tencent CVM\n- [k3d](docs/i18n/en_us/k3d/README.md) - Bootstrap K3d onto Local Machine\n- [native](docs/i18n/en_us/native/README.md) - Bootstrap K3s onto any VM\n\n## Quick Start (tl;dr)\n\nScenario 1 - Run with docker:\n\n```bash\n# The commands will start autok3s daemon with an interactionable UI.\n# Standard Linux (Recommended)\n$ docker run -itd --restart=unless-stopped --net=host -v /var/run/docker.sock:/var/run/docker.sock cnrancher/autok3s:v0.9.3\n\n# MacOS\n$ docker run -itd --restart=unless-stopped -p 8080:8080 -v /var/run/docker.sock:/var/run/docker.sock -e DOCKER_HOST=\"\" cnrancher/autok3s:v0.9.3\n```\n\nScenario 2 - Run with docker-compose\n\n```bash\n# AutoK3s is available at: http://autok3s.vcap.me (vcap.me resolves to 127.0.0.1).\n# The cli and container uses the same `AUTOK3S_CONFIG` directory.\ndocker-compose up -d\n```\n\nScenario 3 - Run with cli:\n\n```bash\n# The commands use the shell script on MacOS and Linux, or visit the Releases page to download the executable for Windows.\ncurl -sS https://rancher-mirror.rancher.cn/autok3s/install.sh  | sh\n\n# The commands will start autok3s daemon and popup default browser with an interactionable UI.\nautok3s -d serve\n```\n\n## Uninstall\n\n\u003e For v0.5.0 or newer version\n\nTo uninstall autok3s cli, please execute command below:\n\n```bash\n/usr/local/bin/autok3s-uninstall.sh\n```\n\n## Demo Video\n\nIn the demo, we install K3s by k3d provider in around 1 minute, and\nwe can manage K3s clusters by kube-explorer dashboard.\n\nWatch the demo:\n\n![](docs/assets/autok3s-v0.7.0-demo.gif)\n\n## Use Cases\n\n- [Quickly create K3s cluster and add K3s nodes with GUI Tool using AutoK3s (Installation guide in WSL)](https://dev.to/msh2050/quickly-create-k3s-cluster-and-add-k3s-nodes-with-gui-tool-using-autok3s-installation-guide-in-wsl-3e5d)\n\n## Developers' Guide\n\nUse `dapper` to manage project compilation, testing and packaging.\n\n- compilation: `make autok3s build`\n- testing: `make autok3s unit`\n- packing: `make autok3s package only`\n\nInstall `dapper` please follow the [dapper](https://github.com/rancher/dapper) project.\n\n## Source Code\n\nAutoK3s is 100% open-source software. The project source code is spread across a number of repos:\n\n- https://github.com/cnrancher/autok3s\n- https://github.com/cnrancher/autok3s-ui\n- https://github.com/cnrancher/kube-explorer\n\nContributed by SUSE(Rancher E\u0026I) Team\n\n# License\n\nCopyright (c) 2024 [SUSE](https://www.suse.com/)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnrancher%2Fautok3s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcnrancher%2Fautok3s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnrancher%2Fautok3s/lists"}