O Vaultwarden é um cofre de senhas compatível com os aplicativos do Bitwarden, para celular, navegador e computador. Suas senhas ficam guardadas criptografadas no seu próprio servidor, e você acessa de qualquer lugar.
O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.
O que vem no e-mail
| Endereço do cofre | https://cofre.SEU-IP.yhostbr.online |
| Criar conta com | o e-mail do seu cadastro na yHost, que já foi convidado |
| Painel admin | https://cofre.SEU-IP.yhostbr.online/admin |
| Token admin | a senha do painel admin |
Nos endereços, SEU-IP é o IP da VPS com traços no lugar dos pontos.
Criar a sua conta (primeiro acesso)
Aqui é diferente dos outros aplicativos: a senha do cofre não vem pronta. Você mesmo cria a sua senha mestra, e só você fica sabendo qual é.
- Abra o endereço do cofre:
https://cofre.SEU-IP.yhostbr.online. - Na tela de login, clique em Criar conta.
- Em Endereço de e-mail, digite o e-mail do seu cadastro na yHost, exatamente como veio no e-mail. O campo Nome é opcional. Clique em Continuar.
- Crie a sua senha mestra no campo Senha principal e repita no campo Confirmar senha principal.
- O campo Dica da senha principal pode ficar em branco: este servidor não mostra a dica depois.
- Clique em Criar conta. Você entra direto no cofre.
Não existe e-mail de confirmação: a conta já fica pronta para usar. No cofre, a senha mestra aparece com o nome senha principal.
O cofre aparece em português quando o seu navegador está em português. Para escolher o idioma, vá em Configurações > Aparência > Idioma.
Se o e-mail da yHost disser, na linha "Criar conta", para convidar o seu e-mail no painel admin, convide primeiro o seu próprio e-mail (veja Convidar outras pessoas, mais abaixo) e depois siga estes passos.
Trocar a senha mestra
- Entre no cofre pelo navegador:
https://cofre.SEU-IP.yhostbr.online. - No menu, vá em Configurações > Segurança e abra a aba Senha principal.
- Preencha Senha principal atual, Nova senha principal e Confirmar nova senha principal.
- Clique em Alterar senha principal.
Depois da troca, o cofre pede para você entrar de novo. Use a senha nova também nos aplicativos do celular, do navegador e do computador.
Usar nos aplicativos do Bitwarden
Os aplicativos do Bitwarden (extensão do navegador, celular e computador) funcionam com o seu cofre. Baixe pelo site oficial https://bitwarden.com/download/ ou pela loja do seu celular. Antes de entrar, aponte o aplicativo para o seu servidor:
- Na tela de login do aplicativo, procure o seletor do servidor. Ele aparece como Acessando (em inglês, Accessing ou Logging in on) e começa mostrando bitwarden.com.
- Abra esse seletor e escolha auto-hospedado (Self-hosted).
- Em URL do servidor (Server URL), coloque
https://cofre.SEU-IP.yhostbr.onlinee clique em Salvar. - Entre com o seu e-mail e a senha mestra.
Convidar outras pessoas
O cadastro aberto fica desligado: só cria conta quem foi convidado. Para liberar outra pessoa:
- Abra o painel admin:
https://cofre.SEU-IP.yhostbr.online/admin. - Na tela "Authentication key needed to continue", cole o token admin que veio no e-mail no campo Enter admin token e clique em Enter.
- No menu do painel, clique em Users.
- Na parte Invite User, digite o e-mail da pessoa e clique em Invite. Aparece a mensagem "User invited correctly".
- Avise a pessoa: ela abre o endereço do cofre, clica em Criar conta e usa exatamente o e-mail que você convidou.
O painel admin existe só em inglês. A VPS não manda o convite por e-mail, por isso é você quem avisa a pessoa.
.env) e pode, por exemplo, abrir o cadastro para qualquer pessoa.Onde roda na VPS
| Pasta | /opt/yhost/vault |
| Container | vaultwarden (os dados do cofre ficam no volume do app) |
| Token admin | linha VW_TOKEN do arquivo /opt/yhost/vault/.env |
| Reiniciar | cd /opt/yhost/vault e depois docker compose restart |
Problemas comuns
A página não abre logo depois da criação
A instalação leva de 2 a 6 minutos depois que a VPS liga. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação pelo SSH: tail -n 30 /var/log/yhost-app.log.
O navegador avisa que a conexão não é segura
O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não crie a conta nem digite senhas. Se o aviso continuar depois de 1 hora, abra um chamado.
Ao criar a conta aparece "Registration not allowed or user already exists"
O e-mail digitado não é o que foi convidado, ou já existe uma conta com ele. Confira se digitou exatamente o e-mail do seu cadastro na yHost (ou o e-mail que você convidou no painel admin). Se a conta já existe, volte para a tela de login e entre com a senha mestra.
O painel admin mostra um aviso sobre "plain text ADMIN_TOKEN"
O aviso é esperado. Ele aparece porque o token admin fica guardado como texto no arquivo .env da VPS, que só o usuário root consegue ler. O token foi gerado na instalação, longo e aleatório. Pode fechar o aviso.
Esqueci a senha mestra
Não há como recuperar a senha mestra nem o conteúdo do cofre sem ela, e este servidor também não mostra a dica da senha. Se precisar começar do zero, abra um chamado.
Precisa de ajuda?
Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.
Ainda com dúvida? A nossa equipe ajuda pelo chamado.
Abrir chamado