# Instalar o Runner

# Requisitos

• Linux (Ubuntu 22.04+, Debian 12+) ou WSL2
• Docker 24.0+ rodando
• Acesso root ou sudo
• Git instalado

# Comando único

curl -sSL https://runner.ccs.systems/init.sh | sudo bash

Esse script:

1. Detecta sua arquitetura (x86_64 ou aarch64)
2. Baixa o binário static-musl correspondente
3. Coloca em /opt/runner/runner (symlink em /usr/local/bin/runner)
4. Faz backup de qualquer instalação anterior

# Verificar

runner -V

Deve exibir runner X.Y.Z (hash). Veja a versão atual em Changelog.

# Inicializar config

runner init

Gera /opt/runner/config.yml com defaults. Edita pra customizar:

• apps_dir: onde o Runner guarda apps (/data/apps por padrão)
• state_dir: estado interno (/opt/runner/state)
• logs_dir: logs de deploy (/opt/runner/logs)
• notify.telegram.bot_token: opcional, pra notificações

Detalhes do arquivo: Schema do `config.yml`.

# Atualizar depois

runner self-update

Pega o último release publicado e substitui o binário (faz backup automático).

# Desinstalar

sudo rm /opt/runner/runner /usr/local/bin/runner
sudo rm -rf /opt/runner/state /opt/runner/logs

(Apps em /data/apps/ ficam intactos; o Runner não controla esses dados.)