Skip to main content

Turso CLI in review

Congratulations, you’ve finished the Turso CLI tutorial! You should now be able to effectively use most of the functionality provided by the CLI.

Commands you learned​

turso auth signup​

This starts the signup process that allows the CLI to work with Turso databases.

turso auth login​

This starts the authentication process, similar to turso auth signup. Since the authentication token you receive expires after 7 days, you must run this periodically to continue working with your databases.

turso db locations​

This lists all supported locations, highlighting your current default location.

turso db create​

This creates a new logical database in a placement group. A default placement group is created if one doesn't yet exist.

turso db show​

This shows details for a specific logical database, including its URL and all of the instances in all locations.

turso db list​

This lists all of the logical databases associated with the account that’s currently logged in.

turso db shell​

This starts an interactive shell to issue SQL statements against your database. By default it uses the primary, and you can also point it to a replica using its URL.

turso group locations add​

This adds a new location to a placement group, replicating all of the databases in that group to that location.

turso db inspect​

This shows current database usage for billing purposes.

turso db destroy​

This destroys a specific replica by name, or all replicas in a named location, or the entire database.

turso auth logout​

This removes the authentication token previously provided by turso auth login, requiring you to log in again to continue working with your databases.

Built-in help​

The CLI has help available. The following command summarizes the top-level commands available:

turso help

For each specific command, you can add the --help flag to get details on all the sub-commands and flags. For example:

turso db --help
turso db create --help

Reference documentation​

To learn about additional the functionality of the CLI, consult its reference documentation.