---
title: login
description: Authenticates a Storyblok user by email and password (supporting two-factor authentication) or personal access token and stores their credentials in ~/.storyblok/credentials.json.
url: https://www.storyblok.com/docs/tooling/cli/login
---

# login

Authenticates a Storyblok user by email and password (supporting two-factor authentication) or [personal access token](/docs/concepts/access-tokens#personal-access-token) and stores their credentials in `~/.storyblok/credentials.json`. Using a personal access token is _recommended_ for CI/CD environments and _required_ for accounts using SSO.

## Usage

```bash
storyblok login
```

> [!TIP]
> Run the command without any arguments or flags to start an interactive login process.

## Flags

| Flag | Type | Description |
| --- | --- | --- |
| `--token` | string | _Optional._ A [personal access token](/docs/concepts/access-tokens#personal-access-token). |
| `--region` | string | _Optional._ The region of the Storyblok space. Possible values are ‘eu’, ‘us’, ‘ca’, ‘au’, and ‘cn’. Must match the space region. Once logged in, the same region setting is used for all subsequent CLI commands. |

## Pagination

-   [Previous: languages pull](/docs/tooling/cli/languages-pull)
-   [Next: logout](/docs/tooling/cli/logout)