Log in with a token

With a token, ferry login needs no approval. Use it for CI, scripts and machines without a browser.

Get a token. Create an API token in the dashboard.

1 / 4

Do it

Terminal

ferry login --server http://127.0.0.1:7878 --token <token>

ferry login reads the token from --token or from FERRY_TOKEN.

Token	Where
An API token	In the dashboard: Server → Account → API tokens. See Server: Account.
The server token	On the server: the file `<data-dir>/api_token`.

Use a token when no person can approve the login. Examples: CI, a script, a machine without a browser.

For a CI job, you can also use two variables and no login. See Use the CLI in CI.

Check the connection

ferry info shows the server that the CLI uses and its main settings.

Reach a remote server

ferryd listens only on 127.0.0.1. An SSH tunnel gives your laptop a way to its API.