Getting started
Install Thinkube
What you need before you install Thinkube, and the order to do it in.
Check this list first: the machines, and four accounts with their tokens. When you have everything, get the installer and run it.
Before you start
Go through both lists. Each line links to the page with the details.
Machines
| Machine | What it needs |
|---|---|
A desktop to run the installer |
Ubuntu 24.04 with a desktop. It can be one of your servers or a separate computer. It reaches the servers over SSH. See Get the installer. |
The control plane |
A physical machine, not a virtual one, with at least 16 CPU cores and 64 GB of memory, running Ubuntu Server 24.04. The installer refuses a smaller machine. See Prepare your machines. |
GPU machines |
An NVIDIA GPU of the Volta generation or newer, with driver 580 or newer. The installer offers to install the driver when it is missing or older. |
A DGX Spark |
Add it as a worker, with another machine as the control plane, so the Spark’s memory stays free for models. |
Every server needs Ubuntu Server 24.04, the same sudo user and password, a running SSH server and internet access.
Thinkube has been tested on a DGX Spark and on an amd64 workstation with RTX 3090 GPUs.
Accounts and tokens
| Account | What you need |
|---|---|
A domain at Cloudflare |
A domain you own, at any registrar, with its DNS moved to a free Cloudflare account, and an API token that can edit that zone’s DNS. Moving the DNS can take hours. See Set up your domain. |
Tailscale |
A Tailscale account, and an auth key, an API token and an OAuth client created in it. See Connect from anywhere. |
GitHub |
A personal access token with the scopes the installer checks. See Connect to GitHub. |
Hugging Face |
A read-only access token, and the licence accepted for each gated model you want. See Unlock AI models. |
Anthropic (optional) |
An account for Claude Code, which is a paid service. You sign in the first time you start it in Thinkube IDE. |
The steps
-
Create the accounts and tokens above.
-
Get the installer on the desktop machine.
-
Run the installer — the installer, screen by screen, and what each screen does to your machine.
-
Add more nodes — from Thinkube Control, after the install.