> ## 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.

# Quick Start

> From zero to a running tracebloc workspace in about 10 minutes.

A running workspace in about 10 minutes, with one command. Deploying on a specific environment instead (EKS, AKS, bare-metal, OpenShift)? See [Deployment environments](/environment-setup/deployment-environments).

<Note>
  **No Docker or Kubernetes knowledge needed.** The installer sets up the whole container stack for you — on macOS and Linux it even installs Docker if it's missing. You just need a machine.
</Note>

## Before you start

| You need            | Minimum                                                       |
| ------------------- | ------------------------------------------------------------- |
| A machine           | macOS, Linux, or Windows · 2 CPU · 5 GB RAM · 10 GB free disk |
| A tracebloc account | [Sign up free](https://ai.tracebloc.io) — no credit card      |

That's enough to run a workspace. To **train on this machine**, give it 4 CPU · 16 GB RAM · 50 GB disk — a single training job alone reserves \~8 GB. The installer checks before it starts: below the minimum it stops on Linux (on macOS/Windows it warns — raise Docker Desktop's memory in Settings → Resources).

<Steps>
  <Step title="Register your workspace">
    On the [clients page](https://ai.tracebloc.io/clients), click **+** and note your **Client ID** and **password** — you'll enter them during install.
  </Step>

  <Step title="Run the installer">
    <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>

    **What to expect:** about 5 minutes. It asks for your Client ID and password, installs Docker (if missing) and a local Kubernetes cluster, and touches only `~/.tracebloc` and Docker. Safe to re-run anytime.

    <Accordion title="Prefer to read the script before running it?">
      Every install script is open source. Download, inspect, then run:

      ```bash theme={null}
      curl -fsSL https://tracebloc.io/i.sh -o install.sh   # silent download — no output means it worked
      less install.sh        # review it (q to quit)
      bash install.sh        # run it
      ```

      Source: [github.com/tracebloc/client](https://github.com/tracebloc/client/blob/main/scripts/install.sh). Release binaries are cosign-signed, so you can verify their signature before trusting them.
    </Accordion>
  </Step>

  <Step title="Verify it's connected">
    ```bash theme={null}
    kubectl get pods -A
    ```

    Look for the tracebloc pods (`mysql-client`, `…-jobs-manager`, `…-requests-proxy`) in `Running` state. Then open your [clients page](https://ai.tracebloc.io/clients) — your workspace should show **Online**.
  </Step>
</Steps>

<Note>
  **What changed on your machine** — only Docker and `~/.tracebloc`. To remove everything: `k3d cluster delete tracebloc`.
</Note>

## Locked-down environment?

If your security policy forbids piping scripts from the internet, skip the one-liner and [deploy with Helm](/environment-setup/configuration#manual-deployment) instead — same result, full control over every step.

## What's next

<CardGroup cols={2}>
  <Card title="Stage a dataset" icon="database" href="/create-use-case/prepare-dataset">
    Ingest data so contributors can build models against it.
  </Card>

  <Card title="Create a use case" icon="diagram-project" href="/create-use-case/prerequisites">
    Define a task and invite contributors.
  </Card>
</CardGroup>