Create a child database in the current database.


fauna create-database DBNAME [OPTIONS]


The create-database command creates a child database in the current database, with the name that you specify. If you don’t pass any options at the command line, Fauna uses the default options in the fauna-shell configuration file.

Is not possible to use this command to create a parent or peer database. To create a database outside of the current database, use the Fauna Dashboard.


Argument Description


The name of the child database that you are creating.


Option Description


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


Optional name of the endpoint to use for the command.


Optional connection port. Defaults to 8443.


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


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


Optional connection timeout, an integer number of milliseconds. When the interval 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.


Create a database called my-test-db:

$ fauna create-database my-test-db
creating database my-test-db

  created database 'my-test-db'

  To start a shell with your new database, run:

  fauna shell 'my-test-db'

  Or, to create an application key for your database, run:

  fauna create-key 'my-test-db'

Now, when you run fauna shell and query for a list of databases, you can see that the child database production is listed:

$ fauna shell
Connected to
Type Ctrl+D or .exit to exit the shell
> Database.all()
  data: [
      name: "my-test-db",
      coll: Database,
      ts: Time("2023-08-30T21:42:29.200Z"),
      global_id: "yw3jf8si4yrrn"

Is this article helpful? 

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

Thank you for your feedback!