Last update: 2025-06-18T13:57:28.000Z
Content:
---
title: ".tinyb file · Tinybird Docs"
theme-color: "#171612"
description: "The .tinyb file contains the Tinybird project configuration, including the authentication token."
inkeep:version: "forward"
---




# .tinyb file [¶](https://www.tinybird.co/docs/forward/dev-reference/datafiles/tinyb-file#tinyb-file)

Copy as MD The `.tinyb` file is a configuration file that contains the Tinybird project configuration, including the authentication token obtained by running `tb login`.

Running commands requires a valid `.tinyb` file in the root of your project. If you don't have one, you can create one by running [tb login](/docs/forward/dev-reference/commands/tb-login).

## Location [¶](https://www.tinybird.co/docs/forward/dev-reference/datafiles/tinyb-file#location)

You can place the `.tinyb` file in the root of your app repository or keep it together with your Tinybird datafiles. Tinybird looks for the `.tinyb` file in all parent folders till it reaches the home directory.

If your Tinybird files and folders are located in a subdirectory (e.g., `tinybird/` ), you should add a `cwd` field to specify the relative path to that directory.

## File structure [¶](https://www.tinybird.co/docs/forward/dev-reference/datafiles/tinyb-file#file-structure)

The following is a sample `.tinyb` file:

##### Sample .tinyb file

{
    "host": "<tinybird-host>",
    "id": "<workspace-id>",
    "name": "<workspace-name>",
    "scope": "user",
    "token": "<authentication-token>",
    "tokens": {
        "<tinybird-host>": "<authentication-token>",
        "<another-tinybird-host>": "<authentication-token>"
    },
    "cwd": "<optional-path-to-your-tinybird-folder-e.g-./tinybird>", 
    "user_email": "<user-email>",
    "user_id": "<user-id>",
    "user_token": "<authentication-token>",
    "version": "<tinybird-version>"
}
