Switch Home Manager

Login do painel central para integrar Grafana, coletar servidores e gerar o pacote do Switch.

Switch Home Manager

Painel central

Integracao Grafana

Conecte seu Grafana Cloud para coletar servidores automaticamente.

📖 Como configurar o Grafana Cloud
  1. Obter a URL: Va em grafana.com → Seu stack → Details. Copie a URL base (ex: https://sorpe.grafana.net).
  2. Gerar API Key: Va em Administration → Service Accounts → Add service account:
    • Nome: switch-home-manager
    • Role: Viewer (ou Editor se quiser)
    • Clique em Add service account, depois em Add service account token.
    • Copie o token (comeca com glsa_).
  3. No Switch Home Manager: Cole a URL e o token nos campos abaixo e clique em "Salvar conexao".
  4. Sincronizar: Clique em "Sincronizar servidores" para importar automaticamente os servidores que aparecem nos dashboards do Grafana.
Grafana ainda nao configurado.

Servidores

Servidores do Grafana ou adicionados manualmente via SSH.

Adicionar servidor manual (SSH)

Adicione servidores Linux com IP publico.

Servidor Sistema Recursos Acoes

Console SSH

Conecte, veja stats e execute scripts nos servidores.

Scripts / Comandos

Adicione comandos que aparecem no menu do Switch.

App do Switch

Selecione servidores e gere o .nro para transferir via DBI.

📱 Fluxo

  1. Marque abaixo os servidores que aparecem no Switch
  2. Clique em "Gerar .nro" — compila o app com os servidores
  3. Quando ficar "Pronto", clique "Baixar"
  4. Transfira o .nro para o Switch via DBI/MTP

Servidores no app

Marque os servidores que aparecem no menu do Switch.

🎨 Personalizar app do Switch

Defina o nome e o icone que aparecem no menu do Switch.

📖 Como compilar o .nro (2 opcoes)

Opcao 1: Build Online (recomendado) — GitHub Actions
  1. Clique em "🚀 Gerar .nro (online)" abaixo — isso cria um registro de build no banco.
  2. Va em Settings → Secrets and variables → Actions no GitHub e adicione:
    • API_URL = https://switchapp.zeabur.app
    • API_TOKEN = (seu token JWT — copie do F12 > Application > Local Storage)
  3. Va em Actions → "Build Switch App (.nro)" → "Run workflow"
  4. Digite o Build ID que apareceu no toast e execute
  5. Apos ~3 min, volte aqui e veja o status "✅ Pronto"
  6. Clique em "⬇ Baixar .nro" e transfira para o Switch via DBI
Opcao 2: Build Local (PC com devkitpro)
  1. Instale o devkitpro:
    Baixar instalador
    (marque "Switch Development" durante a instalacao)
  2. Clique em "📦 Baixar fontes + config" abaixo
  3. Extraia o arquivo baixado
  4. Abra o "devkitpro MSYS2" pelo Menu Iniciar
  5. No terminal: cd /c/caminho/para/pasta-extraida/
  6. Execute: ./build.sh
  7. O .nro sera gerado em: build/SwitchInfraMonitor.nro
  8. Transfira para o Switch via DBI (MTP)

⚡ Gerar .nro

Compila o app com os servidores selecionados e as configuracoes acima.

🖥 Compilar localmente (com devkitpro)

Baixe os fontes com a configuracao dos servidores e compile no seu PC.

📦 Ultimos .nro

Builds recentes — baixe e envie para o Switch.

🔍 Logs e Diagnostico

Veja logs, teste conexoes e diagnostique problemas.

📡 Diagnosticar conexao com Grafana

Clique abaixo para testar a conexao passo a passo e ver exatamente onde falha.

📋 Logs do servidor (console)

Ultimas acoes e erros registrados pelo sistema.

Carregando logs...

🖥 Status do Servidor

Node

-

Memoria

-

Uptime

-

Hora

-

❓ Ajuda - Guia Completo

Passo a passo para configurar tudo e gerar seu primeiro .nro.

📋 Sumario

  1. Grafana - Conecte seu Grafana Cloud e sincronize servidores
  2. Servidores - Adicione servidores Linux manualmente (SSH)
  3. Switch App - Selecione servidores, personalize nome/icone e gere .nro
  4. GitHub Action - Configure para compilar o .nro automaticamente
  5. Builds - Baixe o .nro e transfira para o Switch via DBI

1️⃣ Conectar Grafana Cloud

O que é: Conecte seu Grafana Cloud para importar servidores Windows automaticamente.

Como fazer:

  1. Va em grafana.com → Seu stack → Details. Copie a URL base (ex: https://sorpe.grafana.net).
  2. Va em Administration → Service Accounts → Add service account:
    • Nome: switch-home-manager
    • Role: Viewer
    • Clique em Add service account, depois Add service account token
    • Copie o token (comeca com glsa_)
  3. Cole a URL e o token na pagina Grafana e clique "Salvar conexao"
  4. Clique em "Sincronizar servidores" para importar
  5. Clique em "📊 Coletar metricas de todos" para ver CPU/RAM/Disco

✅ Depois disso, os servidores Windows aparecem na pagina Servidores com stats!

2️⃣ Adicionar servidor Linux (SSH)

O que é: Adicione servidores Linux com IP publico para conectar via SSH.

Como fazer:

  1. Va na pagina Servidores
  2. Preencha: Nome, IP publico, Usuario SSH (geralmente root), Senha SSH
  3. Clique em "Adicionar servidor"
  4. Clique em "🔌 Testar SSH" para testar a conexao

✅ O servidor aparece com status Online/Offline e stats de CPU, RAM, Disco!

3️⃣ Selecionar servidores e personalizar

O que é: Escolha quais servidores aparecem no app do Switch e personalize nome/icone.

  1. Va na pagina Switch App
  2. Marque os servidores que devem aparecer no menu do Switch
  3. Clique em "Salvar selecao"
  4. Em "Personalizar app do Switch", digite o nome do app (ex: "Meu Server")
  5. Opcional: selecione um arquivo .png 256x256 para o icone
  6. Clique em "💾 Salvar configuracao"

4️⃣ Configurar GitHub Action (para gerar .nro)

O que é: O GitHub Action compila o .nro gratuitamente na nuvem usando o devkitpro oficial.

📖 Clique aqui para ver o passo a passo completo

Passo 1: Obter o token de API

  1. Faca login no site https://switchapp.zeabur.app
  2. Aperte F12 (DevTools)
  3. Va na aba Application (ou Armazenamento)
  4. Clique em Local Storage → https://switchapp.zeabur.app
  5. Copie o valor de switch_home_token
  6. Guarde esse token, voce vai usar no proximo passo

Passo 2: Configurar Secrets no GitHub

  1. Va em https://github.com/Sorpe-Jonas/Switch-Home
  2. Clique em Settings → Secrets and variables → Actions
  3. Clique em New repository secret
  4. Adicione estes 2 secrets:
NomeValor
API_URLhttps://switchapp.zeabur.app
API_TOKEN(o token que voce copiou no Passo 1)

Passo 3: Fazer o primeiro build

  1. Va no site, pagina Switch App
  2. Clique em "🚀 Gerar .nro (DBI)"
  3. Va em https://github.com/Sorpe-Jonas/Switch-Home/actions
  4. Clique no workflow "Build Switch App (.nro)"
  5. Clique em "Run workflow" → digite o Build ID que apareceu no site
  6. Acompanhe o progresso (leva ~3-5 minutos)
  7. Quando terminar, volte no site e veja o status "✅ Pronto"
  8. Clique em "⬇ Baixar .nro"

Proximos builds (mais rapidos)

  1. No site, clique em "Gerar .nro"
  2. No GitHub, va em Actions → "Build Switch App" → "Run workflow"
  3. Digite o Build ID e execute
  4. Em ~3 min o .nro esta pronto!

5️⃣ Transferir para o Switch via DBI

O que é: Depois de baixar o .nro, transfira para o Nintendo Switch.

  1. Conecte o Switch no computador via USB
  2. Abra o DBI no Switch
  3. Va em "Run MTP Responder"
  4. No computador, abra a pasta do Switch no Explorer
  5. Copie o arquivo .nro para a pasta raiz do SD card
  6. Eject o dispositivo e feche o DBI
  7. Abra o Homebrew Menu no Switch (album + R)
  8. Seu app aparece na lista! 🎮

✅ Pronto! Agora voce pode gerenciar seus servidores direto do Switch!

Historico de builds

Todos os .nro compilados. Baixe e transfira para o Switch.