> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracebloc.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Local / k3d

> Run a tracebloc workspace on a single machine — laptop or on-prem server. Production-capable.

**When to pick it** — A single machine you own: a laptop to try things, or an on-prem server you run in production. The installer brings up a self-contained Kubernetes cluster (k3d) inside Docker — you don't need a cluster of your own.

## Prerequisites

* A machine: macOS, Linux, or Windows · 2 CPU · 5 GB RAM · 10 GB free disk to run (4 CPU · 16 GB · 50 GB to train on it).
* Your **Client ID** and password from the [clients page](https://ai.tracebloc.io/clients).

That's it — no Docker or Kubernetes knowledge needed. The installer sets up Docker and the cluster for you.

## Install

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    bash <(curl -fsSL https://tracebloc.io/i.sh)
    ```
  </Tab>

  <Tab title="Windows (PowerShell as admin)">
    ```powershell theme={null}
    irm https://tracebloc.io/i.ps1 | iex
    ```
  </Tab>
</Tabs>

See [Quick Start](/environment-setup/quickstart) for the full walkthrough, including the inspect-first option.

## Verify

```bash theme={null}
kubectl get pods -A
```

The tracebloc pods should be `Running`, and your workspace should read **Online** on the clients page.

## Environment-specific config

Set these as environment variables before the install command (full list in [Configuration](/environment-setup/configuration#installer-options)):

```bash theme={null}
CLUSTER_NAME=my-cluster AGENTS=2 HOST_DATA_DIR=/data/tracebloc bash <(curl -fsSL https://tracebloc.io/i.sh)
```

GPUs are auto-detected on Linux (NVIDIA/AMD) — drivers, container toolkit, and device plugin are installed for you.

## Production notes

* **Local is production-capable.** Point it at a server rather than a laptop and it's a real deployment.
* Your data persists in `HOST_DATA_DIR` across stop/start cycles (see [Operations](/environment-setup/operations)).
* Need more headroom? Re-run the installer on a bigger machine, or add worker nodes with `AGENTS`.
* For multi-node high availability, use [bare-metal](/environment-setup/deploy-bare-metal) or a managed cloud instead.