Quickstart · 5 minutos
Do código ao ar com goship deploy.
Instale o CLI, faça login e implante sua primeira app. Você precisará de uma conta — se ainda não criou, faça isso primeiro.
Instale o CLI
O goship é um binário único, sem dependências. Mac, Linux ou WSL:
curl -fsSL https://goship.sh/install.sh | shO script baixa a versão mais recente para o seu sistema, confere o checksum e instala em /usr/local/bin. Verifique com goship version. Windows e outras opções em docs → Instalação.
Faça login
Seu navegador abrirá este portal e voltará após você aprovar o acesso. Um login só vale para todos os comandos.
goship loginEm CI ou máquina sem navegador, defina GOSHIP_TOKEN e o CLI não pede login.
Crie uma organização
Organizações agrupam seus apps, bancos e colegas de time. Escolha um slug curto, em minúsculas.
Solicitar conviteEscolha a organização
Todo comando roda dentro de uma organização. Fixe a sua:
goship org use <seu-slug>Implante sua primeira app
Crie uma app Go hello-world, adicione um Procfile e implante. O GoShip compila a partir do código-fonte — sem Dockerfile.
mkdir hello && cd hello
cat > hello.go <<'EOF'
package main
import (
"fmt"
"net/http"
"os"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello from GoShip!")
})
port := os.Getenv("PORT")
if port == "" {
port = "8888"
}
http.ListenAndServe(":"+port, nil)
}
EOF
cat > Procfile <<'EOF'
web: /home/application/bin/hello
EOF
go mod init hello
goship app create hello --platform go
goship deploy -a helloQuando o deploy terminar, goship app info hello mostra a URL da app.
Deixe um agente de IA operar
O CLI também serve tudo o que faz como ferramentas para agentes. No Claude Code, um comando instala o servidor, uma skill de deploy e o /goship:deploy:
/plugin install goship --marketplace coffeece/goshipOutros clientes (Cursor, Claude Desktop…) rodam goship mcp como servidor stdio — docs → Agentes de IA.
Próximos passos
- → Conectar um banco:
goship db create meudb --plan small && goship db bind meudb -a helloBancos → Provisionar → - → Definir variáveis de ambiente:
goship env set FOO=bar -a helloApps → Variáveis de ambiente → - → Escalar sob demanda:
goship app scale hello --units 3Apps → Escala → - → Domínio próprio + TLS:
goship domain add meu-app.com.br -a helloApps → Domínios e TLS → - → Documentação completa: docs.goship.sh cobre apps, bancos, sandbox de segurança, clusters e API.