---
title: .tinyb file
meta:
  description: The .tinyb file contains the Tinybird project configuration, including the authentication token.
---

# .tinyb file

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](/forward/dev-reference/commands/tb-login).

## 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

The following is a sample `.tinyb` file:

```json {% title="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>"
}
```