Check out v4 of the Fauna CLI

v4 of the Fauna CLI is now in beta.

The new version introduces enhancements to the developer experience, including an improved authentication workflow. To get started, check out the CLI v4 quick start.

fauna list-databases

Lists databases.

Syntax

fauna list-databases [--[no-]color ] [--endpoint <value>]
  [--environment <value>] [--secret <value>]
  [--timeout <value>] [--url <value>]

Description

The list-databases command lists databases.

Scope

The list-databases command only lists direct child databases of the database for your authentication secret. You can’t use the list-databases to access parent, peer, or other descendant databases.

If you use an authentication secret scoped to an account’s top-level context, list-databases lists the account’s top-level databases. You can create a top-level secret using the fauna cloud-login command.

Options

Option Description

--[no-]color

Enables or disables color formatting for the output. Color formatting is enabled by default if the terminal supports it (determined using chalk/supports-color). Use --no-color to disable.

--endpoint

Connection endpoint from .fauna-shell.

--environment

Environment to use, from a Fauna project.

--help

Help for create-database command.

--secret

Authentication secret. Overrides the secret in .fauna-shell.

Use a scoped key to interact with a child database using a parent database’s admin key.

For example, with a parent database’s admin key secret of fn123, you can access a child database by appending the child database name and role: fn123:childDB:admin.

--timeout

Connection timeout (milliseconds).

--url

Database URL. Overrides the URL in .fauna-shell.

Examples

fauna list-databases

Is this article helpful? 

Tell Fauna how the article can be improved:
Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!