runner init

Inicializa o Runner num servidor novo: cria /opt/runner/config.yml com defaults e os diretorios apps_dir, state_dir e logs_dir.

Use quando: acabou de instalar o binario e precisa gerar a configuracao inicial. Veja Instalar.

Sintaxe

runner init [flags]

Flags

Flag Tipo Descricao
--force flag Sobrescreve configuracao existente
--show-template flag Exibe o template de config sem criar arquivos
--set <KEY=VALUE> string (repetivel) Define valores de config em dot-notation (ex: paths.apps_dir=/data/apps)
--mkey <MKEY> string Injeta master key em base64. Use para recuperacao de desastre — restaura a mesma chave que criptografou os ckeys existentes. Sem isso, uma nova chave aleatoria e gerada
-o, --output <FORMAT> enum Formato de saida: human (padrao), json, yaml
--json flag Atalho para --output json
-h, --help flag Exibe ajuda

Exemplos

Inicializacao basica

runner init

Definir valores na criacao

runner init --set github.default_user=devborlot --set paths.apps_dir=/data/apps

Inicializacao com token de notificacao e saida JSON

runner init --force --set notify.telegram_bot_token=xxx --json

Recuperacao com master key existente

runner init --mkey "base64_encoded_master_key"

Ver template sem criar arquivos

runner init --show-template

Erros comuns

  • Config already exists — use --force para sobrescrever, ou edite /opt/runner/config.yml manualmente.
  • Permission denied — rode como root ou com sudo runner init.
  • Master key invalida com --mkey — confirme que o valor esta em base64 valido; use base64 -w0 <keyfile> para recodificar se necessario.
By Borlot.com.br on 27/05/2026