Switch Home Manager

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

Integracao Grafana

Conecte seu Grafana Cloud para coletar servidores automaticamente.

📖 Como configurar o Grafana Cloud

Obter a URL: Va em grafana.com → Seu stack → Details. Copie a URL base (ex: https://sorpe.grafana.net).
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_).
No Switch Home Manager: Cole a URL e o token nos campos abaixo e clique em "Salvar conexao".
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.

Servidor

Scripts / Comandos

Adicione comandos que aparecem no menu do Switch.

Resultado

App do Switch

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

📱 Fluxo

Marque abaixo os servidores que aparecem no Switch
Clique em "Gerar .nro" — compila o app com os servidores
Quando ficar "Pronto", clique "Baixar"
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.

🔐 PIN do Switch (6 digitos)

Defina um PIN numerico de 6 digitos para fazer login direto do Switch.

No Switch, voce vai digitar este PIN com os controles.

⚙️ Configuracoes do Switch

Defina o intervalo de atualizacao automatica dos servidores no Switch.

📖 Como compilar o .nro (2 opcoes)

Opcao 1: Build Online (recomendado) — GitHub Actions

Clique em "🚀 Gerar .nro (online)" abaixo — isso cria um registro de build no banco.
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)
Va em Actions → "Build Switch App (.nro)" → "Run workflow"
Digite o Build ID que apareceu no toast e execute
Apos ~3 min, volte aqui e veja o status "✅ Pronto"
Clique em "⬇ Baixar .nro" e transfira para o Switch via DBI

Opcao 2: Build Local (PC com devkitpro)

Instale o devkitpro:
Baixar instalador
(marque "Switch Development" durante a instalacao)
Clique em "📦 Baixar fontes + config" abaixo
Extraia o arquivo baixado
Abra o "devkitpro MSYS2" pelo Menu Iniciar
No terminal: cd /c/caminho/para/pasta-extraida/
Execute: ./build.sh
O .nro sera gerado em: build/SwitchInfraMonitor.nro
Transfira para o Switch via DBI (MTP)

🖥 Compilar localmente (com devkitpro)

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

=== WINDOWS (recomendado) ===

1. Baixe e instale o devkitpro:
   https://github.com/devkitPro/installer/releases/latest/download/devkitpro-pacman-installer.exe
   (marque "Switch Development" durante a instalacao)

2. Extraia o arquivo baixado do site

3. Abra "devkitpro MSYS2" pelo Menu Iniciar

4. No MSYS2, navegue ate a pasta:
   cd /c/Users/SeuUsuario/Downloads/pasta-extraida/

5. Execute:
   ./build.sh

6. O .nro sera gerado em: build/SwitchInfraMonitor.nro

7. Transfira para o Switch via DBI (MTP):
   - Abra o DBI no Switch
   - Va em "Run MTP Responder"
   - Conecte o USB no PC
   - Copie o .nro para a raiz do SD card
   - Abra pelo Homebrew Menu (album+R)

📦 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

Grafana - Conecte seu Grafana Cloud e sincronize servidores
Servidores - Adicione servidores Linux manualmente (SSH)
Switch App - Selecione servidores, personalize nome/icone e gere .nro
GitHub Action - Configure para compilar o .nro automaticamente
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:

Va em grafana.com → Seu stack → Details. Copie a URL base (ex: https://sorpe.grafana.net).
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_)
Cole a URL e o token na pagina Grafana e clique "Salvar conexao"
Clique em "Sincronizar servidores" para importar
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:

Va na pagina Servidores
Preencha: Nome, IP publico, Usuario SSH (geralmente root), Senha SSH
Clique em "Adicionar servidor"
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.

Va na pagina Switch App
Marque os servidores que devem aparecer no menu do Switch
Clique em "Salvar selecao"
Em "Personalizar app do Switch", digite o nome do app (ex: "Meu Server")
Opcional: selecione um arquivo .png 256x256 para o icone
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

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

Passo 2: Configurar Secrets no GitHub

Va em https://github.com/Sorpe-Jonas/Switch-Home
Clique em Settings → Secrets and variables → Actions
Clique em New repository secret
Adicione estes 2 secrets:

Nome	Valor
`API_URL`	`https://switchapp.zeabur.app`
`API_TOKEN`	(o token que voce copiou no Passo 1)

Passo 3: Fazer o primeiro build

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

Proximos builds (mais rapidos)

No site, clique em "Gerar .nro"
No GitHub, va em Actions → "Build Switch App" → "Run workflow"
Digite o Build ID e execute
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.

Conecte o Switch no computador via USB
Abra o DBI no Switch
Va em "Run MTP Responder"
No computador, abra a pasta do Switch no Explorer
Copie o arquivo .nro para a pasta raiz do SD card
Eject o dispositivo e feche o DBI
Abra o Homebrew Menu no Switch (album + R)
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.