# Tu primera base en Turso en 5 minutos: guía de la CLI paso a paso > Instalar la CLI de Turso, crear una cuenta, levantar tu primera base, conectarte con la consola SQL y generar un token seguro: todo lo que necesitás para empezar, con los comandos oficiales. - URL: https://markco.digital/blog/tu-primera-base-en-turso-en-5-minutos-guia-de-la-cli-paso-a-paso - Publicado: 2026-10-11 - Categoría: Supabase - Autor: Mark-Co Digital (investigado y publicado de forma automatizada con Claude) - Sitio: Mark-Co Digital — https://markco.digital Para crear tu primera base en Turso Cloud alcanza con cinco comandos: instalar la CLI, iniciar sesión, crear la base, abrir la consola SQL y generar un token para tu aplicación. En esta guía los repasamos uno por uno, con los comandos tal como figuran en la documentación oficial, y te contamos qué opciones conviene conocer desde el primer día. Es el quinto post de "Turso en español", la serie de Mark-Co Digital. Si todavía no sabés qué es Turso ni en qué se diferencia de SQLite, empezá por [qué es Turso y por qué Supabase anunció su compra](https://markco.digital/blog/que-es-turso-la-guia-en-espanol-del-sqlite-que-adquiere-supabase). ## Antes de empezar: hay dos CLIs con nombres parecidos Turso tiene dos herramientas de línea de comandos y conviene no confundirlas: HerramientaComandoPara qué sirveCLI de Turso Cloud`turso`Administrar tu cuenta y tus bases en la nube: crear, listar, tokens, grupos, regionesCLI del motor Turso Database`tursodb`Usar el motor open source en Rust de forma local, sobre un archivo de tu máquinaEsta guía es sobre la primera, `turso`, la que usás para trabajar con Turso Cloud. ## Paso 1: instalar la CLI En macOS podés usar Homebrew: ```bash brew install tursodatabase/tap/turso ``` En macOS (como alternativa) y en Linux, el script oficial: ```bash curl -sSfL https://get.tur.so/install.sh | bash ``` En Windows la CLI necesita WSL (Windows Subsystem for Linux, el entorno Linux integrado en Windows). Primero abrís PowerShell y ejecutás `wsl`; después, ya dentro de WSL, corrés el mismo script: ```bash wsl ``` ```bash curl -sSfL https://get.tur.so/install.sh | bash ``` La documentación aclara un detalle que suele hacer perder tiempo: para verificar la instalación tenés que abrir una terminal nueva y escribir `turso`. Para actualizarla más adelante, en macOS usás `brew update` y `brew upgrade`; en Linux y Windows, `turso update`. ## Paso 2: crear la cuenta o iniciar sesión ```bash turso auth signup ``` Si ya tenés cuenta: ```bash turso auth login ``` Estos comandos abren el navegador para autenticarte. Si estás en un entorno donde eso no es posible, como WSL o un servidor de integración continua, la documentación recomienda el modo sin navegador: ```bash turso auth login --headless ``` Para automatizaciones, la página del modo headless menciona la variable de entorno `TURSO_API_TOKEN`, y `turso auth token` muestra el token que usa la CLI para hablar con la Platform API (la API para administrar Turso Cloud por código). Tratalo como una contraseña. ## Paso 3: crear tu primera base La guía rápida oficial muestra dos variantes. Con el motor nuevo, Turso Database: ```bash turso db create my-db --tursodb ``` O sin la opción, que crea una base sobre libSQL, el fork de SQLite que Turso mantiene desde antes: ```bash turso db create my-db ``` Para una base nueva, la documentación de Turso recomienda el motor Turso Database; libSQL queda como opción probada para cargas críticas. `turso db create` tiene opciones útiles que vamos a usar en otros posts de la serie: - `--from-file`, `--from-dump` y `--from-csv` para crear la base a partir de datos existentes (con `--from-file` el límite es de 2 GB). - `--from-db` para copiar otra base, y `--timestamp` junto con `--from-db` para restaurar un momento del pasado. - `--group` para elegir el grupo y `--size-limit` para ponerle un tope de tamaño (por ejemplo `256mb`). ## Paso 4: mirar la base y conectarte con la consola SQL Para ver el nombre, el ID, el grupo, el tamaño y la ubicación: ```bash turso db show my-db ``` Con `--url` obtenés la URL de conexión que va a usar tu aplicación, y con `--http-url` la URL HTTP. Para listar todas tus bases, `turso db list` (opcionalmente filtrando con `--group`). Ahora, la consola SQL interactiva: ```bash turso db shell my-db ``` Adentro, el ejemplo de la guía rápida crea una tabla, inserta un registro y lo consulta: ```sql CREATE TABLE users ( ID INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT ); ``` ```sql INSERT INTO users (name) VALUES ('Iku'); ``` ```sql SELECT * FROM users; ``` Para salir, `.quit`. Iku, por cierto, es la mascota de Turso: su nombre viene de Iku-Turso, una criatura marina de la mitología finlandesa, según la [página institucional de la empresa](https://turso.tech/about-us). También podés ejecutar una consulta suelta sin entrar a la consola, algo práctico para scripts: ```bash turso db shell "SELECT * FROM users" ``` ## Paso 5: generar un token para tu aplicación Tu aplicación se conecta con la URL de la base y un token. Se crea así: ```bash turso db tokens create [flags] ``` Dos opciones que recomendamos usar desde el principio: - `--read-only`: el token solo puede leer. Ideal para un panel de reportes o un sitio que solo muestra datos. - `--expiration`: el token vence. Acepta `never` o una duración como `7d`. ```bash turso db tokens create --read-only ``` Si necesitás un token para todas las bases de un grupo, existe `turso group tokens create `, con las mismas opciones. Es cómodo, pero da acceso a más cosas: usalo solo si hace falta. Y no subas tokens al repositorio; en nuestra nota sobre [claves de API expuestas en GitHub](https://markco.digital/blog/claves-de-api-expuestas-en-github-como-proteger-las-de-tu-pyme) explicamos por qué. ## Extras: regiones, grupos y limpieza Para ver en qué regiones podés crear bases, y la latencia desde tu máquina a cada una: ```bash turso db locations --show-latencies ``` Esto es especialmente interesante desde Latinoamérica, porque Turso Cloud sumó una región en San Pablo: lo contamos en [Turso llegó a San Pablo](https://markco.digital/blog/turso-llego-a-san-pablo-que-cambia-para-las-apps-de-latinoamerica). Los grupos agrupan bases en una ubicación. Se crean con `turso group create `, y si no indicás `--location`, la ubicación primaria es la región más cercana. Tener varios grupos requiere los planes Scaler, Pro o Enterprise. Para borrar una base de prueba: ```bash turso db destroy ``` La opción `-y` evita la confirmación; usala con cuidado en scripts. ## Qué significa para tu proyecto - **Para un equipo de desarrollo**, la CLI permite probar Turso en minutos y con el plan gratuito, que según la página de precios incluye 100 bases y 5 GB de almacenamiento. Alcanza para un piloto. - **Para una pyme con un desarrollador o una agencia**, conviene que los tokens de producción tengan permisos mínimos y vencimiento, y que la cuenta de Turso esté a nombre de la empresa, no de una persona. - **Para automatizar**, el modo headless y los comandos con SQL en línea permiten integrar Turso en pipelines de despliegue. Más adelante en la serie vemos la Platform API, que lleva esto un paso más allá. ## Preguntas frecuentes ### ¿Necesito tarjeta de crédito para probar Turso? La página de precios muestra un plan Free de USD 0 con 100 bases. Las condiciones de alta pueden cambiar, así que revisalas al crear la cuenta. ### ¿Puedo usar la CLI de Turso en Windows sin WSL? La documentación de instalación de la CLI `turso` indica WSL para Windows. El motor local `tursodb` tiene su propio instalador para PowerShell, pero es otra herramienta. ### ¿Cuál es la diferencia entre un token de base y uno de grupo? El de base da acceso a una sola base; el de grupo, a todas las del grupo. Ambos se pueden limitar a lectura y ponerles vencimiento. ### ¿Qué pasa si borro una base por error? Con `turso db destroy` la base se elimina. En los planes pagos, Turso permite recuperar bases borradas durante 5 días; lo vemos en detalle en un post posterior de la serie. Si querés sumar Turso o Supabase a un proyecto y necesitás ayuda para diseñar el backend, configurar accesos seguros o automatizar el despliegue, en Mark-Co Digital trabajamos en [desarrollo backend](https://markco.digital/servicios/desarrollo-backend) y en [cloud e infraestructura](https://markco.digital/servicios/cloud-e-infraestructura). Mañana: los precios de Turso explicados plan por plan. ## Fuentes - [Instalación de la CLI de Turso](https://docs.turso.tech/cli/installation) - [Actualizar la CLI de Turso](https://docs.turso.tech/cli/upgrading.md) - [Guía rápida de Turso](https://docs.turso.tech/quickstart) - [Modo headless de la CLI](https://docs.turso.tech/cli/headless-mode.md) - [turso auth token](https://docs.turso.tech/cli/auth/token.md) - [turso db create](https://docs.turso.tech/cli/db/create.md) - [turso db show](https://docs.turso.tech/cli/db/show.md) - [turso db list](https://docs.turso.tech/cli/db/list.md) - [turso db shell](https://docs.turso.tech/cli/db/shell.md) - [turso db tokens create](https://docs.turso.tech/cli/db/tokens/create.md) - [turso group tokens create](https://docs.turso.tech/cli/group/tokens/create.md) - [turso db locations](https://docs.turso.tech/cli/db/locations.md) - [turso db destroy](https://docs.turso.tech/cli/db/destroy.md) - [turso group create](https://docs.turso.tech/cli/group/create.md) - [Repositorio de Turso Database en GitHub](https://github.com/tursodatabase/turso) - [Precios de Turso](https://turso.tech/pricing) - [Sobre Turso (About us)](https://turso.tech/about-us) - [Claves de API expuestas en GitHub (Mark-Co Digital)](https://markco.digital/blog/claves-de-api-expuestas-en-github-como-proteger-las-de-tu-pyme)