Lists child databases in the current database.

fauna list-databases


The list-databases command lists child databases. If you don’t pass any options at the command line, Fauna uses the default options specified in the fauna-shell configuration file.

It is not possible to use this command to list parent or peer databases. To access a database outside of the current database, use the Fauna Dashboard.


Option Description


Optional - The Fauna server domain, that is, the hostname where Fauna is running. Defaults to
Since the introduction of Region Groups, three cloud domains are available. Use the correct domain for your database’s Region Group.
Classic (US and EU):
United States (US):
Europe (EU):


Optional - The name of the endpoint to use for the command.


Optional - The connection port. Defaults to 8443.


Optional - The connection scheme. Must be one of https or http. Defaults to https.


Optional - The secret to use. A secret authenticates your connection to Fauna, and connects you to a specific database.


Optional - The connection timeout, an integer number of milliseconds. When the specified period has elapsed, fauna-shell stops waiting for a response and displays an error.

The default is zero, which means that fauna-shell waits until a response is received.


fauna list-databases
listing databases

To verify this, run fauna shell and query for a list of databases; you see that the child database my_test_db is listed:

fauna shell
Connected to
Type Ctrl+D or .exit to exit the shell
{ data: [ Database("my_test_db") ] }

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve!
Visit Fauna's Discourse forums or email

Thank you for your feedback!