mirror of
https://github.com/siderolabs/talos.git
synced 2025-10-28 15:01:13 +01:00
Change the quickstart guide to use brew install instructions. Updated command formatting and added warning for macOS Docker Desktop users. Signed-off-by: Justin Garrison <justin.garrison@siderolabs.com>
1.6 KiB
1.6 KiB
title, weight, description
| title | weight | description |
|---|---|---|
| Quickstart | 20 | A short guide on setting up a simple Talos Linux cluster locally with Docker. |
{{< youtube IO2Yo3N46nk >}}
Local Docker Cluster
The easiest way to try Talos is by using the CLI (talosctl) to create a cluster on a machine with docker installed.
Prerequisites
talosctl
Download talosctl (macOS or Linux):
brew install siderolabs/tap/talosctl
kubectl
Download kubectl via one of methods outlined in the documentation.
Create the Cluster
Now run the following:
talosctl cluster create
{{% alert title="Note" color="info" %}} If you are using Docker Desktop on a macOS computer you will need to enable the default Docker socket in your settings. {{% /alert %}}
You can explore using Talos API commands:
talosctl dashboard --nodes 10.5.0.2
Verify that you can reach Kubernetes:
kubectl get nodes -o wide
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME
talos-default-controlplane-1 Ready master 115s v{{< k8s_release >}} 10.5.0.2 <none> Talos ({{< release >}}) <host kernel> containerd://1.5.5
talos-default-worker-1 Ready <none> 115s v{{< k8s_release >}} 10.5.0.3 <none> Talos ({{< release >}}) <host kernel> containerd://1.5.5
Destroy the Cluster
When you are all done, remove the cluster:
talosctl cluster destroy