Environments¶
Tinybird has three environments that serve different purposes: Development, Local, and Cloud.
Typically, you use the Development environment to test your changes before deploying them to the Local or Cloud environment.
Comparison of environments¶
The following table summarizes the different environments and the commands you can use to interact with them.
Environment | Global flag | Host | Token |
---|---|---|---|
Development | Use tb dev to run commands in the dev environment. | http://localhost:7181 while tb dev is running. | Run tb token ls from within the dev prompt. |
Local | --local (by default, all commands run as local) | http://localhost:7181 after a local deployment. | Run tb token ls from the terminal. |
Cloud | --cloud | Tinybird region or a custom URL from self-managed regions. | Get your token from Tokens in Tinybird Cloud. |
Environments and regions¶
All Tinybird environments map to a region.
- Development and Local environments map to the Tinybird Local region.
- Cloud environments map to a Tinybird Cloud region, which can be a default or a custom region.
Switch regions in Tinybird¶
You can switch region in Tinybird Cloud using the region selector:
- Open Tinybird Cloud at https://cloud.tinybird.co
- Select your current region.
- Select the region you want to switch to.

The Tinybird Local region only appears if you have a local deployment running.
Next steps¶
- Familiarize yourself with datafiles. See Datafiles.
- Learn how to get data into Tinybird. See Get data in.
- Learn how to test and deploy your changes. See Test and deploy.