This is the command line interface (CLI) to Turso.
Homebrew (macOS, Linux, WSL)
brew install chiselstrike/tap/turso
Also remember to configure homebrew
shell completions if you haven't already done so.
To upgrade an existing installation of the CLI, run:
brew upgrade turso
curl -sSfL https://get.tur.so/install.sh | bash
cd cmd/turso && go install
If you are a new user, you can sign up with:
turso auth signup
If you already have an account, authenticate with:
turso auth login
You are taken to a web page in your default browser to authenticate via GitHub.
After succesfully authenticated, turso auth login
receives an access token that is stored on your settings file.
To create a database, run:
turso db create
You can configure the database name with:
turso db create <database name>
You can start an interactive SQL shell similar to sqlite3
with:
turso db shell <database name>
First, list available locations and pick a location you want to replicate to:
turso db locations
Then, to replicate a database, run:
turso db replicate <database name> <location>
To list your databases, run:
turso db list
turso db destroy <database name>
The turso
program keeps settings in your local machine in the following base directory in turso/settings.json
file:
OS | Config directory |
---|---|
Linux | $XDG_CONFIG_HOME or $HOME/.config |
macOS | $HOME/Library/Application Support |