https://github.com/cozystack/talos-bootstrap

An interactive Talos Linux installer
https://github.com/cozystack/talos-bootstrap

bare-metal baremetal baremetal-provisioning cli kubernetes pxe pxe-boot pxeboot talos tui

Last synced: 5 months ago
JSON representation

An interactive Talos Linux installer

• Host: GitHub
• URL: https://github.com/cozystack/talos-bootstrap
• Owner: cozystack
• License: apache-2.0
• Created: 2023-12-15T22:33:05.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2025-04-25T08:32:01.000Z (5 months ago)
• Last Synced: 2025-04-25T09:41:14.442Z (5 months ago)
• Topics: bare-metal, baremetal, baremetal-provisioning, cli, kubernetes, pxe, pxe-boot, pxeboot, talos, tui
• Language: Shell
• Homepage:
• Size: 2.24 MB
• Stars: 147
• Watchers: 2
• Forks: 17
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-talos - talos-bootstrap

README

          
# talos-bootstrap

An interactive script for bootstrapping Kubernetes clusters on Talos OS.

*Example: bootstrap full-feature Kubernetes cluster in 5 minutes*:

[![screencast](https://raw.githubusercontent.com/cozystack/talos-bootstrap/2cc7b82065747e373cd914c87c8cd5c6582c5c6c/images/627123.gif)](https://asciinema.org/a/gwK85Tdr577GsxjXWo7otPFjv)

# Installation

Install dependencies:

- `talosctl` (>=1.6.0)

- `dialog`

- `nmap`

Install talos-bootstrap:

```

curl -LO https://github.com/cozystack/talos-bootstrap/raw/master/talos-bootstrap

chmod +x ./talos-bootstrap

sudo mv ./talos-bootstrap /usr/local/bin/talos-bootstrap

```

# Usage

- Boot your nodes with Talos in maintenance mode.  

  (booting from [ISO](https://www.talos.dev/v1.5/talos-guides/install/bare-metal-platforms/iso/) or PXE using [matchbox](https://www.talos.dev/latest/talos-guides/install/bare-metal-platforms/matchbox/) is the best option)

- Create a directory for holding your cluster configuration.

- Run `talos-bootstrap` command for every node in your cluster.

### Options

```

USAGE:

        talos-bootstrap ACTION [OPTIONS]

ACTIONS:

        help            Show this help message.

        install         Setup a node for a new or existing cluster.

        upgrade         Upgrade a node in an existing cluster.

        reset           Reset and remove a node from an existing cluster.

        reboot          Reboot a node.

        shutdown        Shutdown a node.

        dashboard       Open dashboard for a node.

OPTIONS:

        -n, --node 
    Node address

```


### Customizations

You can specify your customizations in one of the following files:

- `patch.yaml` - common settings used for all nodes.

- `patch-controlplane.yaml` - settings used for controlplane nodes only

- `patch-worker.yaml` - settings used for worker nodes only

Read the [Configuration Patches](https://www.talos.dev/latest/talos-guides/configuration/patching/) documentation for more details.

### Advanced configuration management

Looking for enhanced, non-interactive version of talos-bootstrap?

Take a look at [Talm](https://github.com/cozystack/talm) project.

# Copyright

Andrei Kvapil   

Licensed under Apache 2.0 License