Verificação final
Checklist pra confirmar que a instalação funciona de ponta a ponta.
Com o deploy feito e as variáveis configuradas, passe por estes pontos. Cada item aponta pra onde voltar se algo falhar.
Logue você primeiro. Abra o app na URL final e entre com a sua conta do
Discord antes de divulgar a URL pra alguém — é o primeiro login com o banco
vazio que cria o ADMIN.
Se o login falhar com redirect_uri_mismatch, o Redirect URI cadastrado no
Discord não bate com a URL real — revise o passo 2 de Configurar o
Discord.
Confirme o acesso de admin: abra /admin/channels. As abas de
administração (Usuários, Canais) têm que estar lá. Se você for jogado de volta
pra home, essa conta não foi a primeira do banco — veja se alguém logou antes
de você, ou limpe a tabela User e logue de novo.
Teste uma chamada de voz: entre no canal de voz Geral, ligue o microfone
e confirme o áudio num segundo dispositivo.
Se a conexão travar em "conectando" ou cair na hora, revise LIVEKIT_URL,
LIVEKIT_API_KEY e LIVEKIT_API_SECRET — ver LiveKit
Cloud ou self-host. No
self-host, a causa mais comum é a faixa UDP 50000-60000 bloqueada num
firewall de borda (ver a seção "Portas" daquela página).
Se você configurou o armazenamento de anexos: mande uma mensagem com
imagem anexada no chat de texto. Se o upload falhar ou a imagem não aparecer,
revise as variáveis em Armazenamento de anexos — o
erro mais comum é o bucket não estar com leitura pública (Public Access no
R2, --access-level public_read no Neon).
Sem armazenamento configurado, o comportamento esperado é o botão de anexo não aparecer.
Libere o acesso do resto do time: em /admin/channels, dê a role de
acesso a canal pra cada conta que já logou. Conta nova começa sem acesso
nenhum.
Opcional: métricas de infra
Se você subiu o LiveKit em self-host, siga o infra/vps-metrics/README.md no
repositório do app pra habilitar a aba "Infra" do admin (CPU, RAM, disco e
banda da VPS). Sem isso o app funciona normal, só sem essa aba.
Provisionando por IA?
O runbook pra IA tem esse mesmo checklist em forma de comando, integrado ao fluxo de provisionamento por CLI.