{"id":20802347,"url":"https://github.com/astarte-platform/astarte-kubernetes-operator","last_synced_at":"2026-04-10T12:05:37.971Z","repository":{"id":37082518,"uuid":"176321321","full_name":"astarte-platform/astarte-kubernetes-operator","owner":"astarte-platform","description":"Astarte Kubernetes Operator","archived":false,"fork":false,"pushed_at":"2025-03-13T00:29:54.000Z","size":4292,"stargazers_count":22,"open_issues_count":16,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-31T04:41:13.780Z","etag":null,"topics":["hacktoberfest","iot","iot-platform","kubernetes-operator"],"latest_commit_sha":null,"homepage":"http://astarte-platform.org","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/astarte-platform.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-18T16:00:15.000Z","updated_at":"2024-12-11T13:41:06.000Z","dependencies_parsed_at":"2024-02-06T17:26:31.958Z","dependency_job_id":"0a2ecfb7-94c9-4acd-975a-fa927ca32649","html_url":"https://github.com/astarte-platform/astarte-kubernetes-operator","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastarte-kubernetes-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastarte-kubernetes-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastarte-kubernetes-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastarte-kubernetes-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astarte-platform","download_url":"https://codeload.github.com/astarte-platform/astarte-kubernetes-operator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252793568,"owners_count":21805055,"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":["hacktoberfest","iot","iot-platform","kubernetes-operator"],"created_at":"2024-11-17T18:30:42.262Z","updated_at":"2026-04-10T12:05:37.966Z","avatar_url":"https://github.com/astarte-platform.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Astarte Kubernetes Operator\n\n![CI](https://github.com/astarte-platform/astarte-kubernetes-operator/workflows/Operator%20e2e%20tests/badge.svg?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/astarte-platform/astarte-kubernetes-operator)](https://goreportcard.com/report/github.com/astarte-platform/astarte-kubernetes-operator)\n[![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)\n![Docker Pulls](https://img.shields.io/docker/pulls/astarte/astarte-kubernetes-operator)\n\n\u003cimg src=\"mascotte.svg\" align=\"right\" width=\"160px\" /\u003e\nAstarte Kubernetes Operator runs and manages an Astarte Cluster in a Kubernetes Cluster. It is meant\nto work on any Managed Kubernetes installation, and leverages a number of Kubernetes features to\nensure Astarte runs as smooth as possible. It also handles upgrades, monitoring, and more.\n\nAstarte Operator is the foundation of any Astarte installation, and you can find more information\nabout it and how to use it once installed in the\n[Astarte Operator\nguide](https://docs.astarte-platform.org/astarte-kubernetes-operator/snapshot/001-intro_administrator.html).\n\n## Getting started\n\nThe preferred way to install and manage Astarte Operator leverages its [Helm\nchart](https://artifacthub.io/packages/helm/astarte/astarte-operator).\n\nAstarte Operator requires [`cert-manager`](https://cert-manager.io/) (`v1.7+`) to be installed in\nthe cluster in its default configuration. If you are using `cert-manager` in your cluster already\nyou don't need to take any action - otherwise, you will need to install it. A complete overview on\nprerequisites can be found\n[here](https://docs.astarte-platform.org/astarte-kubernetes-operator/snapshot/020-prerequisites.html).\n\nTo install `cert-manager` simply run:\n```bash\nhelm repo add jetstack https://charts.jetstack.io\nhelm repo update\nkubectl create namespace cert-manager\nhelm install \\\n  cert-manager jetstack/cert-manager \\\n  --namespace cert-manager \\\n  --version v1.17.1 \\\n  --set crds.enabled=true\n```\n\nInstalling the operator is as simple as:\n```bash\nhelm repo add astarte https://helm.astarte-platform.org\nhelm repo update\nhelm install astarte-operator astarte/astarte-operator\n```\n\nThese instructions will take care of installing all needed components for the Operator to run. This\nincludes all the RBAC roles, Custom Resource Definitions, Webhooks, and the Operator itself.\n\nMoreover, Helm is responsible for upgrading the Astarte Operator. To do so, run:\n```bash\nhelm upgrade astarte-operator astarte/astarte-operator\n```\n\nIf you are interested in having a deeper understanding on how the Astarte Operator works you should\nfollow the [Astarte Operator Administration\nguide](https://docs.astarte-platform.org/astarte-kubernetes-operator/snapshot/001-intro_administrator.html).\n\n### What's next?\n\nOnce your Astarte Operator is up and running in your cluster, it will be time to deploy your Astarte\ninstance! All you have to do is [Setting up the\nCluster](https://docs.astarte-platform.org/astarte-kubernetes-operator/snapshot/060-setup_cluster.html).\n\n## Kubernetes support\n\n| Kubernetes Version | Supported              | Tested by CI       |\n|--------------------|------------------------|--------------------|\n| v1.27.x            | :large_orange_diamond: | :x:                |\n| v1.28.x            | :large_orange_diamond: | :x:                |\n| v1.29.x            | :large_orange_diamond: | :x:                |\n| v1.30.x            | :white_check_mark:     | :white_check_mark: |\n| v1.31.x            | :white_check_mark:     | :white_check_mark: |\n| v1.32.x            | :white_check_mark:     | :white_check_mark: |\n| v1.33.x            | :white_check_mark:     | :white_check_mark: |\n\nKey:\n\n* :white_check_mark: : Supported and stable.\n* :large_orange_diamond: : Partially supported / known to run in production, but not being targeted\n  by the release.\n* :x: : Not supported. Run at your own risk.\n\n## Compatibility Matrix\n\n| Astarte Operator Version | Astarte Version | Kubernetes Version |\n|:------------------------:|:---------------:|:------------------:|\n| v23.5                    | v1.0+           | v1.22+             |\n| v24.5                    | v1.0+           | v1.24+             |\n| v25.5                    | v1.0+           | v1.24+             |\n\n\n## Development\n\nAstarte's Operator is written in Go and built upon [Operator\nSDK](https://github.com/operator-framework/operator-sdk). It depends on Go 1.22, requires Go\nModules and Kubernetes v1.24+.\n\nThe project is built with kustomize v5.4.2, controller-gen v0.15.0 and conversion-gen v0.27.16.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastarte-platform%2Fastarte-kubernetes-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastarte-platform%2Fastarte-kubernetes-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastarte-platform%2Fastarte-kubernetes-operator/lists"}