Deletes a child database from the current database.

fauna delete-database DBNAME


The delete-database command deletes a child database. If you don’t pass any options at the command line, Fauna uses the default options specified in the fauna-shell configuration file.

This command deletes the database and all of its contents.


Argument Description


The name of the database to delete.


Option Description


Optional - The Fauna server domain, that is, the hostname where Fauna is running. Defaults to


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.


Assume that the current database has only one child database, my_test_db. To delete it, run:

fauna delete-database my_test_db
deleting database 'my_test_db'
database 'my_test_db' deleted

To verify that the database was deleted, run fauna shell and query the list of child databases; you see that there are now none:

fauna shell
Connected to
Type Ctrl+D or .exit to exit the shell
{ data: [] }

Is this article helpful? 

Tell Fauna how the article can be improved:
Visit Fauna's forums or email

Thank you for your feedback!