turso

Setup

macOS:

brew install tursodatabase/tap/turso

Linux/WSL:

curl -sSfL https://get.tur.so/install.sh | bash

Verify installation:

turso --version

Always use --output json flag when calling commands programmatically (where supported).

Authentication

turso auth login

Get auth token:

turso auth token

Resources

Databases

Command	Description
turso db list	List all databases
turso db create <name>	Create a new database
turso db create <name> --group <group>	Create database in a specific group
turso db destroy <name>	Destroy a database
turso db show <name>	Show database details and URL
turso db shell <name>	Open interactive SQL shell
turso db shell <name> "SELECT * FROM users"	Run a SQL query directly
turso db inspect <name>	Inspect database size and usage
turso db tokens create <name>	Create an auth token for a database
turso db tokens create <name> --expiration none	Create a non-expiring token

Groups

Command	Description
turso group list	List all groups
turso group create <name>	Create a new group
turso group create <name> --location <location>	Create group in specific location
turso group add-location <name> <location>	Add a replica location to a group
turso group remove-location <name> <location>	Remove a replica location
turso group destroy <name>	Destroy a group

Organizations

Command	Description
turso org list	List organizations
turso org switch <name>	Switch to a different organization

Plan

Command	Description
turso plan show	Show current plan details
turso plan upgrade	Upgrade your plan

Global Flags

Flag	Description
--output json	Output result as JSON
--no-color	Disable colored output