> ## Documentation Index
> Fetch the complete documentation index at: https://flox.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# flox auth

## NAME

flox-auth - FloxHub authentication commands

## SYNOPSIS

```text theme={null}
flox [<general-options>] auth
     (login [--token-file <path>] | logout | status | token)
```

## DESCRIPTION

Authenticate with FloxHub so that you can push and pull environments.

## SUBCOMMANDS

### `login`

Logs in to FloxHub.

Required to interact with environments on FloxHub via `flox push`,
`flox pull`, and `flox activate -r`. Authenticating also automatically
trusts your personal environments.

Prompts you to enter a one-time code at a specified URL. If called
interactively it can open the browser for you if you press `<enter>`.

With `--token-file <path>` the login is non-interactive: the FloxHub
token is read from `<path>` instead (pass `-` to read the token from
stdin). The file can contain a JWT access token, a personal access
token, or a service account token. Token-file login does not open a
browser or prompt for input. A JWT access token is validated locally.
FloxHub must be reachable to validate personal access tokens and service
account tokens. The validated token is stored. Use this in CI,
containers, and other scripted setups.

See also: [`flox-push`](/docs/man/flox-push),
[`flox-pull`](/docs/man/flox-pull),
[`flox-activate`](/docs/man/flox-activate)

### `logout`

Logs out from FloxHub.

### `status`

Print your current login status.

### `token`

Print the current authentication token to stdout.