Quick Start
Coloque sua aplicação no ar em menos de 5 minutos.
1. Pré-requisitos
- Um terminal no macOS, no Linux ou no Windows. A CLI é um programa único: não precisa de Ruby nem de Node.js
- Uma conta Jataí com o e-mail confirmado (crie a sua grátis)
2. Instalação
Instale a CLI do Jataí pelo canal do seu sistema:
curl -fsSL https://jataicloud.com.br/install.sh | shirm https://jataicloud.com.br/install.ps1 | iexbrew install jataicloud/tap/jataiscoop bucket add jataicloud https://github.com/JataiCloud/scoop-bucket
scoop install jatainpm i -g jatai-cliPara conferir: jatai --version.
Usa um agente de IA? Claude Code, Cursor, Codex e Gemini CLI publicam o projeto por você pelo servidor MCP da CLI. Veja Jataí + IA.
3. Login
A CLI abre o navegador com um código. Confira se é o mesmo do terminal e aprove o acesso:
$ jatai login Abra https://jataicloud.com.br/cli/autorizar e confirme o código JGBF-CQFN. Abrimos o navegador para você. Aguardando a aprovação no navegador... Login realizado com sucesso! Conectado como seu@email.com.
Sem navegador nessa máquina, use jatai login --no-browser e abra o link em outro aparelho.
4. Criar seu primeiro app
Navegue até o diretório do seu projeto e inicialize:
$ cd meu-app-rails $ jatai init Stack detectado: Rails Confirmar stack Rails? (Y/n) y Nome do app: meu-app-rails Hex: (Use ↑/↓ e Enter) ‣ Hex Base — R$ 29/mês (1 grátis por time) Hex Escala 1 — R$ 59/mês Hex Escala 2 — R$ 119/mês Arquivo .jatai.yml criado com sucesso! Branch: main Banco: PG Base provisionado automaticamente no `jatai up`. Execute `jatai up` para criar e fazer deploy do app.
Dica: O Jataí detecta automaticamente o stack do seu projeto (Rails, Node.js, estático ou Docker). Não há pergunta de região — enquanto a plataforma opera em região única, o .jatai.yml recebe br-se1 sozinho — nem de banco: o PostgreSQL vem junto no jatai up.
O Hex é a unidade computacional do Jataí: o degrau de CPU e memória do seu app. O primeiro Hex Base do time não é cobrado — e isso é isenção de cobrança, não teto de criação: você pode criar quantos apps Base quiser, os demais custam R$ 29 cada. Dá para trocar de degrau depois na aba Escalonamento do app, no painel.
5. Deploy
Um comando cria o app, provisiona o banco e envia o código da pasta. Não precisa de GitHub:
$ jatai up
Criando app meu-app-rails...
Provisionando infraestrutura...
Infraestrutura provisionada!
Iniciando primeiro deploy...
Empacotando código...
Enviando 60KB...
Na fila...
Imagem construída em 74s
Aguardando o rollout completar...
Deploy concluído! App disponível em https://meu-app-rails.jataiapp.com.br
Para publicar de novo depois de mudar o código, rode jatai deploy.
6. Verificar
Confira o status da sua aplicação:
$ jatai status App: meu-app-rails Slug: meu-app-rails Stack: rails Status: active Região: br-se1 Hex: Hex Base Banco: PG Base URL: https://meu-app-rails.jataiapp.com.br
Veja as linhas mais recentes dos logs:
$ jatai logs --tail 50 2026-10-21T10:30:00Z web [info] Started GET "/" for 200 2026-10-21T10:30:01Z web [info] Completed 200 OK in 45ms
7. Escalar
Precisa de mais capacidade? Troque de Hex ou adicione réplicas na aba Escalonamento do app, no painel. Cada réplica é um Hex inteiro, e a tela mostra o custo antes de aplicar.
O Hex Base roda com 1 réplica; o Hex Escala 1 vai até 5 e o Hex Escala 2 até 10. O escalonamento é manual — o automático por CPU e memória ainda está por vir.
O comando jatai scale ainda está só na CLI antiga. Veja a CLI Reference.