Delete a database.


fauna delete-database DBNAME [--url <value>] [--timeout <value>] [--secret <value>] [--endpoint <value>] [--environment <value>]


The delete-database command deletes a database.

If command line options are omitted, Fauna uses the default configuration file options.

This command deletes the database and all of its contents.

It isn’t possible to use this command to delete a parent or peer database. To delete a database outside of the current database, log into the Fauna Dashboard.


Argument Description


The name of the database to delete.


Option Description


Connection endpoint, from the ~/.fauna-shell file.


Environment to use, from a Fauna project.


Help for create-database command.


Secret key. Overrides the secret in the ~/.fauna-shell file.


Connection timeout (milliseconds).


Database URL. Overrides the URL in the \~/.fauna-shell file.


Delete the my-test-db database:

fauna delete-database my-test-db
deleting database 'my-test-db'
database 'my-test-db' deleted

Verify the database is deleted:

fauna list-databases
listing databases

Is this article helpful? 

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

Thank you for your feedback!