Last update: 2025-06-04T08:32:07.000Z
Content:
---
title: "Get started with Tinybird · Tinybird Docs"
theme-color: "#171612"
description: "Follow this step-by-step tutorial to get started with Tinybird."
inkeep:version: "forward"
---




# Get started with Tinybird [¶](https://www.tinybird.co/docs/forward#get-started-with-tinybird)

Copy as MD Follow these steps to install Tinybird on your machine and deploy your first data project in five minutes.

See [Core concepts](/docs/forward/get-started/concepts) for a complete overview of Tinybird.

## Before you begin [¶](https://www.tinybird.co/docs/forward#before-you-begin)

To get started, you need the following:

- A container runtime, like Docker or Orbstack
- Linux or macOS

## Deploy a new project in five minutes [¶](https://www.tinybird.co/docs/forward#deploy-a-new-project-in-five-minutes)

1
### Create a Tinybird account [¶](https://www.tinybird.co/docs/forward#create-a-tinybird-account)

If you don't already have a Tinybird account, you can create one at [cloud.tinybird.co](https://cloud.tinybird.co/) -- it's free!

2
### Install and authenticate [¶](https://www.tinybird.co/docs/forward#install-and-authenticate)

Run the following command to install the Tinybird CLI:




- For macOS and Linux
- For Windows

curl https://tinybird.co | sh Then, authenticate with your Tinybird account using `tb login`:

# Opens a browser window so that you can authenticate
tb login In the browser, create a new workspace or select an existing one.

3
### Run Tinybird Local [¶](https://www.tinybird.co/docs/forward#run-tinybird-local)

After you've authenticated, run `tb local start` to start a local Tinybird instance in a Docker container, allowing you to develop and test your project locally.

# Starts the container
tb local start 4
### Create a project [¶](https://www.tinybird.co/docs/forward#create-a-project)

Pass an LLM prompt using the `--prompt` flag to generate a customized starter project. For example:

tb create --prompt "I am developing the insights page for my app. I am tracking my users activity and \
want to show them a line chart and a widget with the total amount of actions they did with time \
range filters. It is a multitenant app, so organization_id is a required parameter for all endpoints" The previous prompt creates a project in the current directory.

5
### Run the development server [¶](https://www.tinybird.co/docs/forward#run-the-development-server)

To start developing, run the `dev` command and start editing the data files within the created project directory. This command starts the development server and also provides a console to interact with the database. The project will automatically rebuild and reload upon saving changes to any file.

tb dev 6
### Deploy to Tinybird Cloud [¶](https://www.tinybird.co/docs/forward#deploy-to-tinybird-cloud)

To deploy to Tinybird Cloud, create a deployment using the `--cloud` flag. This prepares all the resources in the cloud environment.

# Prepares all resources in Tinybird Cloud
tb --cloud deploy 7
### Open the project in Tinybird Cloud [¶](https://www.tinybird.co/docs/forward#open-the-project-in-tinybird-cloud)

To open the project in Tinybird Cloud, run the following command:

# Opens the deployed project in Tinybird Cloud
tb --cloud open Go to **Endpoints** and select an endpoint to see stats and snippets.

## Next steps [¶](https://www.tinybird.co/docs/forward#next-steps)

- Familiarize yourself with Tinybird concepts. See[  Core concepts](/docs/forward/get-started/concepts)  .
- Learn about datafiles, like .datasource and .pipe files. See[  Datafiles](/docs/forward/dev-reference/datafiles)  .
- Get data into Tinybird from a variety of sources. See[  Get data in](/docs/forward/get-data-in)  .
- Browse the Tinybird CLI commands reference. See[  Commands reference](/docs/forward/dev-reference/commands)  .


