{"id":44916427,"url":"https://github.com/postfinance/topf","last_synced_at":"2026-02-24T15:02:54.039Z","repository":{"id":337784426,"uuid":"1122185127","full_name":"postfinance/topf","owner":"postfinance","description":"Talos orchestrator by PostFinance","archived":false,"fork":false,"pushed_at":"2026-02-11T10:14:08.000Z","size":130,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-11T16:27:03.316Z","etag":null,"topics":["kubernetes","linux","talos"],"latest_commit_sha":null,"homepage":"https://postfinance.github.io/topf/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/postfinance.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T08:42:01.000Z","updated_at":"2026-02-11T10:14:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/postfinance/topf","commit_stats":null,"previous_names":["postfinance/topf"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/postfinance/topf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postfinance%2Ftopf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postfinance%2Ftopf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postfinance%2Ftopf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postfinance%2Ftopf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/postfinance","download_url":"https://codeload.github.com/postfinance/topf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postfinance%2Ftopf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29786978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T10:45:18.109Z","status":"ssl_error","status_checked_at":"2026-02-24T10:45:09.911Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["kubernetes","linux","talos"],"created_at":"2026-02-18T02:00:21.279Z","updated_at":"2026-02-24T15:02:54.033Z","avatar_url":"https://github.com/postfinance.png","language":"Go","funding_links":[],"categories":["Table of Contents"],"sub_categories":[],"readme":"# TOPF - Talos Orchestrator by PostFinance\n\n[![Go Version](https://img.shields.io/github/go-mod/go-version/postfinance/topf)](https://go.dev/)\n[![License](https://img.shields.io/github/license/postfinance/topf)](LICENSE)\n[![Go Report Card](https://goreportcard.com/badge/github.com/postfinance/topf)](https://goreportcard.com/report/github.com/postfinance/topf)\n[![Latest Release](https://img.shields.io/github/v/release/postfinance/topf)](https://github.com/postfinance/topf/releases/latest)\n\nTOPF is managing [Talos](https://www.talos.dev/) based Kubernetes\nclusters. It provides functionality for bootstrapping new clusters,\nresetting existing ones, and applying configuration changes.\n\n**[Full Documentation](https://postfinance.github.io/topf)**\n\n[![demo](https://asciinema.org/a/yg1XKJYpwIJUdJZT.svg)](https://asciinema.org/a/yg1XKJYpwIJUdJZT)\n\n## Installation\n\n### Homebrew\n\n```bash\nbrew install postfinance/tap/topf\n```\n\n### Go Install\n\n```bash\ngo install github.com/postfinance/topf/cmd/topf@latest\n```\n\n### Binary Download\n\nDownload the latest binary from [GitHub Releases](https://github.com/postfinance/topf/releases/latest).\n\n### Container Image\n\n```bash\ndocker pull ghcr.io/postfinance/topf\n```\n\n## Quickstart\n\nBoot at least one Talos machine to maintenance mode.\n\nCreate a new folder for you cluster with a `topf.yaml` file:\n\n```yaml\nkubernetesVersion: 1.34.1\nclusterEndpoint: https://192.168.1.100:6443\nclusterName: mycluster\n\nnodes:\n- host: node1\n  ip: 172.20.10.2\n  role: control-plane\n```\n\nCreate a new patch to specify the install disk and desired talos version:\n\n`patches/01-installation.yaml`:\n\n```yaml\nmachine:\n  install:\n    disk: /dev/vda\n    image: factory.talos.dev/metal-installer/376567988ad370138ad8b2698212367b8edcb69b5fd68c80be1f2ec7d603b4ba:v1.12.0\n```\n\nThen run `topf apply --auto-bootstrap` to provision the cluster.\n\nOnce finished use `topf kubeconfig` to create an admin kubeconfig for the\ncluster and use `topf talosconfig` to create a valid talosconfig.\n\nFor detailed documentation on configuration, commands, patches, and more, visit\nthe **[full documentation site](https://postfinance.github.io/topf)**.\n\n## Alternatives\n\n- **[talosctl](https://www.talos.dev/)** — the official Talos CLI; fully\nfeatured but lower-level, requires managing configs and node operations\nmanually\n- **[talhelper](https://github.com/budimanjojo/talhelper)** — popular community\ntool for generating Talos machine configs from a declarative YAML definition\n- **[Omni](https://www.siderolabs.com/omni/)** — SideroLabs' management\nplatform for Talos clusters with a UI, multi-environment support, and GitOps\nworkflows; available as SaaS or self-hosted (requires a commercial license for\nproduction use)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostfinance%2Ftopf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpostfinance%2Ftopf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostfinance%2Ftopf/lists"}