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 |