Skip to main content
In this quickstart you will learn how to:
  1. Install the Turso CLI
  2. Signup to Turso
  3. Create your first Turso Database
  4. Connect to Database Shell
1

Install the Turso CLI

We’ll be using the Turso CLI throughout this quickstart to manage databases, create replicas in other regions, and connect to the database shell.
brew install tursodatabase/tap/turso
2

Signup to Turso

The next command will open your browser to sign up:
turso auth signup
3

Create a Database

Now create your first database in a location closest to you with the name my-db:
turso db create my-db
The Turso CLI automatically detected your closest region to create a database. It used this location to create a default “group” for your database, which you can inspect using the following command:
turso db show my-db
4

Connect to Database Shell

Congratulations, you created a database! Now connect to it with the shell command:
turso db shell my-db
Replace my-db with the name of your database if you named it differently.
Now create a table for users using SQL:
CREATE TABLE users (
  ID INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT
);
Then insert a row into the users table:
INSERT INTO users (name) VALUES ("Iku");
Finally, query for all users:
SELECT * FROM users;
When you’re ready to move onto the next step, you’ll want to to quit the shell:
.quit
5

Connect your application to your database

You’re now ready to connect your application to your database. Pick from one of the SDKs below to continue:

TypeScript / JS

Rust

Go

Python

Android

Swift

PHP

Ruby

Ruby on Rails

C

libSQL Remote Protocol