> ## Documentation Index
> Fetch the complete documentation index at: https://siderolabs-fe86397c-1-11-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> A short guide on setting up a simple Talos Linux cluster locally with Docker.

export const k8s_release = '1.34.0';

export const release_v1_9 = 'v1.9.5';

<iframe
  width="560"
  height="315"
  src="https://www.youtube.com/embed/IO2Yo3N46nk?si=Ry7mru1X7-oSzEx0"
  title="YouTube video player"
  frameborder="0"
  allow="accelerometer; 
autoplay; clipboard-write; 
encrypted-media; gyroscope; 
picture-in-picture; 
web-share"
  referrerpolicy="strict-origin-when-cross-origin"
  allowfullscreen
/>

## 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):

```bash
brew install siderolabs/tap/talosctl
```

#### `kubectl`

Download `kubectl` via one of methods outlined in the [documentation](https://kubernetes.io/docs/tasks/tools/install-kubectl/).

### Create the Cluster

Now run the following:

```bash
talosctl cluster create
```

<Note>
  If you are using Docker Desktop on a macOS computer, if you encounter the error: *Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?* you may need to manually create the link for the Docker socket:
  `sudo ln -s "$HOME/.docker/run/docker.sock" /var/run/docker.sock`
</Note>

You can explore using Talos API commands:

```bash
talosctl dashboard --nodes 10.5.0.2
```

Verify that you can reach Kubernetes:

<CodeBlock lang="sh">
  {`
    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_v1_9}   <host kernel>    containerd://1.5.5
    talos-default-worker-1         Ready    <none>   115s   v${k8s_release}   10.5.0.3      <none>        Talos ${release_v1_9}   <host kernel>    containerd://1.5.5
    `}
</CodeBlock>

### Destroy the Cluster

When you are all done, remove the cluster:

```bash
talosctl cluster destroy
```