Install Tinybird¶
Tinybird Local consists of a CLI tool and a containerized version of Tinybird that you can install on your machine or deploy on a cloud provider.
For a quick start guide, see Deploy a new project in five minutes.
Prerequisites¶
To install and use Tinybird Local on your machine, you need to have the following prerequisites:
- A free Tinybird account
- A container runtime, like Docker or Orbstack
- Linux or macOS
Install Tinybird on your machine¶
To install Tinybird, run the following command:
curl https://tinybird.co | sh
This installs the Tinybird CLI and the Tinybird Local container.
Authenticate with Tinybird Cloud¶
The best way to deploy your Tinybird project is Tinybird Cloud, a managed platform available in several cloud providers and regions.
Current Tinybird regions¶
| Region | Provider | Provider region | API base URL |
|---|---|---|---|
| Europe | GCP | europe-west2 | https://api.europe-west2.gcp.tinybird.co |
| Europe | GCP | europe-west3 | https://api.tinybird.co |
| US East | GCP | us-east4 | https://api.us-east.tinybird.co |
| North America | GCP | northamerica-northeast2 | https://api.northamerica-northeast2.gcp.tinybird.co |
| Europe | AWS | eu-central-1 | https://api.eu-central-1.aws.tinybird.co |
| Europe | AWS | eu-west-1 | https://api.eu-west-1.aws.tinybird.co |
| US East | AWS | us-east-1 | https://api.us-east.aws.tinybird.co |
| US West | AWS | us-west-2 | https://api.us-west-2.aws.tinybird.co |
To authenticate your local environment with Tinybird Cloud, run the following command:
tb login
This opens a browser window where you can sign in to Tinybird Cloud.
Install on a cloud provider¶
To install Tinybird on a cloud provider, see Self-managed cloud.
Uninstall the Tinybird CLI¶
How you uninstall the Tinybird CLI (tb) depends on how it was installed.
Using a package manager¶
If you installed the CLI using a package manager, use its uninstall command:
- Homebrew:
brew uninstall tinybird-cli - pip:
pip uninstall tinybird-cli - npm:
npm uninstall -g @tinybirdco/cli
Manual uninstallation¶
If you installed the CLI using the curl script, you can remove the executable file:
rm $(which tb)
The binary is typically located at:
- Linux/macOS:
/usr/local/bin/tb - Or wherever
which tbpoints to
To completely remove all configuration and cache files (optional):
rm -rf ~/.tinyb/
The ~/.tinyb/ directory contains tokens, configuration, and cache data.
Next steps¶
- Follow the Deploy a new project in five minutes quick start guide.
- Familiarize yourself with the core concepts of Tinybird. See Concepts.
- Learn about datafiles and their format. See Datafiles.