Configurar Sincronização

Última revisão: 2026-08-14 O Plainva sincroniza cada vault opcionalmente com um armazenamento de sua escolha — direto do app, sem nenhum serviço administrado pelo Plainva no meio: seus dados trafegam exclusivamente entre seu computador e sua própria conta/servidor. Esta página percorre a configuração por provedor.

Quais serviços funcionam em geral (também via WebDAV ou o cliente de desktop do provedor) está descrito em Compatibilidade de Sincronização.

Fundamentos

• A configuração fica em Configurações → seu vault → Contas na nuvem: Conectar conta… abre o assistente — primeiro escolha o provedor, depois marque os serviços (para sincronizar arquivos: Arquivos), depois faça login. A visão em blocos lista os provedores por alcance real; em Buscar provedores… você também encontra os provedores de e-mail disponíveis como predefinição. Exatamente uma conta por vault carrega o serviço Arquivos. A área Sincronização então mostra a conta conectada com sua Pasta na nuvem e mantém o comportamento (Intervalo de sincronização, fila); Gerenciar conta leva de volta às contas na nuvem.
• Para o serviço Arquivos, além de Microsoft (OneDrive), Google (Drive), Dropbox, Nextcloud, Armazenamento de objetos (S3) e o genérico WebDAV / CalDAV, os blocos também incluem Fastmail, mailbox.org, Yandex, Mail.ru, Koofr e pCloud: neles basta o seu endereço de e-mail mais uma senha de app — os endereços de servidor já ficam preenchidos (baseado em WebDAV; alterável em Avançado: definir os endpoints individualmente).
• Configurar um vault online existente a partir da tela inicial: Abrir vault → Vault on-line guia você pelas mesmas três etapas em todos os provedores — 1. Conectar (fazer login ou informar credenciais), 2. Escolher a pasta na nuvem (uma pasta nova também pode ser criada ali com Nova pasta), 3. Escolher ou criar a pasta local. Você também pode configurar a sincronização de um vault já aberto a qualquer momento em Configurações.
• Criar um novo vault na nuvem: Novo vault → Em um serviço on-line — primeiro você escolhe a estrutura inicial (vazio ou um modelo como PARA), depois conecta e escolhe a pasta de destino na nuvem ou a cria com Nova pasta, por fim a pasta local. A estrutura é criada na pasta local e enviada automaticamente pela primeira sincronização.
• Salvamentos locais são enviados imediatamente; o Plainva verifica alterações remotas no Intervalo de sincronização (segundos) configurado.
• Alterações offline ficam em uma fila e são transferidas no próximo contato; a barra de status mostra Online/Offline e o indicador de sincronização mostra o estado (Sincronizar agora ao clicar). Durante uma sincronização longa ou a primeira sincronização, a barra de status mostra o progresso como um contador (por exemplo, Sync 123/540), para que você veja que ela está avançando pelo vault.
• Se os dois lados alterarem o mesmo arquivo, o Plainva os mescla automaticamente (mesclagem em três vias). Se isso não for possível, sua versão é preservada com segurança como um arquivo .CONFLICT — nada nunca se perde (veja FAQ).
• Resolver conflitos: um banner na nota afetada (e Resolver conflito… no menu de contexto do arquivo .CONFLICT na árvore) abre o diálogo de comparação — o estado atual do arquivo à esquerda, sua versão preservada à direita, editável com adoção por bloco. Salvar o lado direito e resolver grava o resultado no arquivo e remove a cópia de conflito; Manter o outro lado descarta sua cópia (um snapshot de versão permanece). O diálogo de erro de sincronização também lista as cópias de conflito existentes e leva à mesma comparação com um clique.
• Proteção contra exclusões em massa: se uma parcela incomumente grande dos arquivos sincronizados estiver prestes a ser excluída na nuvem de uma só vez (por exemplo, porque a pasta local do vault foi esvaziada ou movida), o Plainva retém as exclusões e pergunta primeiro: Excluir na nuvem as executa, Não excluir (restaurar) as descarta e restaura os arquivos da nuvem na próxima sincronização. As exclusões que você mesmo confirmou no Plainva não são retidas — em exclusões grandes (mais de 10 arquivos ou mais de 20% do vault), o Plainva pede uma segunda confirmação antes de excluir.
• Anexos (imagens etc.) também são sincronizados.
• Pastas vazias também são sincronizadas: uma pasta criada no Plainva aparece na nuvem imediatamente, e pastas vazias na nuvem aparecem nos seus outros dispositivos no mais tardar na próxima listagem completa.
• Credenciais e tokens são armazenados no chaveiro do sistema operacional (status: Configurações → App → Sobre e diagnóstico → Chaveiro do sistema), nunca em arquivos dentro do vault.
• Acessos salvos (Configurações → Vault → Sincronização) mostra o que o Plainva guardou no chaveiro — inclusive entradas de vaults que você não abre há muito tempo. Cada linha indica o serviço e o vault; Remover pergunta antes. O Plainva nunca apaga nada aqui por conta própria.
• As entradas do chaveiro têm nomes legíveis — plainva · <vault> · <serviço> · <id da conta> · #<impressão> em vez de uma sequência base64. O Plainva renomeia as entradas existentes uma única vez, na primeira abertura do vault; se a renomeação não puder ser concluída com segurança, a entrada antiga permanece e o Plainva tenta novamente na próxima abertura.
• Desconectar interrompe a sincronização do vault; nenhum arquivo é excluído em lugar nenhum ao fazer isso.
• http:// é permitido, https:// é a recomendação. Um servidor que você mesmo administra na sua própria rede geralmente fala http sem criptografia — isso funciona também no celular. Pela internet você não deveria: o WebDAV envia sua senha em cada requisição, em texto simples por http. Se você inserir um endereço sem criptografia fora da sua própria rede, o Plainva avisa isso no formulário — mas isso não impede você.

WebDAV / Nextcloud

O caminho mais simples para servidores autogerenciados e a maioria dos armazenamentos na nuvem:

1. Em Contas na nuvem → Conectar conta… escolha o bloco Nextcloud (ou WebDAV / CalDAV).
2. Informe o Endereço do servidor, o Nome de usuário e a Senha ou token de aplicativo — use uma senha de aplicativo em vez da sua senha principal sempre que possível (no Nextcloud: Configurações → Segurança → Senhas de aplicativo).
3. Conectar valida as credenciais; depois escolha a Pasta na nuvem com Escolher pasta….

Caso especial do Nextcloud: UM único formulário cobre arquivos e calendário — o Plainva deriva os endpoints WebDAV e CalDAV a partir do endereço do servidor (os endereços derivados aparecem no assistente; Avançado: definir os endpoints individualmente permite URLs separadas). Marcando os dois serviços, uma única passagem conecta ambos.

Endereços de servidor típicos (Nextcloud, Koofr, MagentaCLOUD, Storage Box e muitos outros) estão listados em Compatibilidade de Sincronização.

Se a senha de aplicativo mudar depois, informe-a uma única vez nos detalhes da conta em Credenciais: o Plainva a verifica em todos os serviços dessa conta e só a salva quando todos aceitam — assim nenhum serviço fica com a senha antiga.

Google Drive

O Google Drive hoje funciona com suas próprias credenciais (“Bring Your Own”): você cria uma vez um projeto gratuito no Google Cloud, que pertence só a você. O guia passo a passo: Google Drive (BYO).

Versão resumida: em Contas na nuvem → Conectar conta… escolha o bloco Google, marque o serviço Arquivos, informe o Client ID e o Client Secret do seu projeto do Google, depois Entrar com o Google… — o login abre no seu navegador. Depois de conectado, escolha a Pasta na nuvem com Escolher pasta… direto do seu Drive (subpastas incluídas, padrão “Plainva”). Observação: enquanto o seu projeto do Google estiver no modo de teste, o login expira depois de 7 dias — definitivamente, porque nesse modo o Google também deixa o token de atualização expirar, e o Plainva não consegue renová-lo em segundo plano. A sincronização avisa então que o login expirou, e Entrar novamente nos detalhes da conta o restabelece — um único acesso para todos os serviços dessa conta. Se preferir não fazer isso toda semana, configure o projeto do Google para Em produção no console: o login passa então a ficar permanentemente válido (em um app não verificado, o Google mostra uma tela de aviso uma única vez, que você pode confirmar como proprietário).

Se você marcar Arquivos e Agenda juntos ao conectar, o Google pede seu consentimento apenas uma vez, solicitando exatamente as permissões dos serviços escolhidos. Ao adicionar outro serviço depois, surge um segundo consentimento complementar.

OneDrive

O Plainva já vem com seu próprio registro de app — você não precisa mais de um ID próprio:

1. Em Contas na nuvem → Conectar conta… escolha o bloco Microsoft e marque o serviço Arquivos (OneDrive) — se quiser, junto com Calendário e tarefas e E-mail (uma conta Microsoft pode carregar os três serviços).
2. Entrar com a Microsoft… e confirme o login no navegador. Pronto — o Plainva cria a pasta (padrão “Plainva”) e sincroniza todo o seu conteúdo, inclusive arquivos adicionados externamente.
3. Opcional: depois de conectado, escolha a Pasta na nuvem com Escolher pasta… direto do seu OneDrive (subpastas incluídas).

Opcional: em Usar seu próprio ID de aplicativo você pode informar, em vez disso, um Client ID registrado por você mesmo (por exemplo, por restrições corporativas). Guia detalhado: OneDrive & Dropbox (BYO).

Ao conectar vários serviços de uma mesma conta juntos — por exemplo Arquivos e Agenda —, o provedor pede seu consentimento apenas uma vez, e o Plainva guarda um único login para a conta inteira. Isso vale tanto para a Microsoft (arquivos, calendário, e-mail) quanto para o Google (arquivos e calendário; uma caixa de correio do Gmail fica de fora, pois funciona por IMAP com senha de app e não exige consentimento).

Contas que ainda entram serviço a serviço estão marcadas como Login antigo na lista de contas e oferecem Um login para todos os serviços — na lista de contas e nos detalhes da conta, tanto no desktop quanto no app mobile. Um único acesso, e depois todos os serviços passam a compartilhar o mesmo login. Isso é mais do que conveniência: logins separados podiam se distanciar um do outro, deixando um serviço funcionando enquanto outro da mesma conta expirava silenciosamente. Para essas contas, Entrar novamente agora renova a conta inteira em vez de apenas um serviço.

Dropbox

O Plainva já vem com seu próprio app do Dropbox — nenhum app próprio é necessário:

1. Em Contas na nuvem → Conectar conta… escolha o bloco Dropbox (ele carrega apenas o serviço Arquivos).
2. Entrar com o Dropbox… e confirme no navegador. Pronto (pasta padrão /Plainva).
3. Opcional: depois de conectado, escolha a Pasta na nuvem com Escolher pasta… direto do seu Dropbox (subpastas incluídas).

Opcional: em Usar seu próprio ID de aplicativo você pode informar, em vez disso, uma App Key registrada por você mesmo. Guia detalhado: OneDrive & Dropbox (BYO).

Armazenamento compatível com S3

Para AWS S3, Cloudflare R2, Backblaze B2, MinIO, Wasabi, Hetzner e outros — baseado em chaves, sem nenhum login pelo navegador. Em Contas na nuvem → Conectar conta… escolha o bloco Armazenamento de objetos (S3) e preencha os campos:

Você pode escolher o Prefixo de chave (a pasta na nuvem) com Escolher pasta… direto do bucket depois de conectar.

Após Conectar, a sincronização começa imediatamente.

Veja também

• Compatibilidade de Sincronização — quais serviços funcionam e como, incluindo o caminho do cliente de desktop
• FAQ e Solução de Problemas — arquivos de conflito, comportamento offline

Criptografia de sincronização (senha)

Substituído no P3: As instruções abaixo não se aplicam mais ao conteúdo. Use Segurança e compartilhamento. A frase restante aqui protege apenas configurações e segredos opcionais.

O Plainva pode criptografar o que sai do seu dispositivo em direção ao servidor de sincronização, enquanto o seu vault local sempre permanece em Markdown puro, que o Obsidian consegue ler.

Abra Configurações → Sincronização → Senha de sincronização e criptografia:

1. Defina uma senha. Isso cria uma chave de criptografia para o vault e mostra um código de recuperação único — guarde-o em local seguro; é a única forma de voltar a entrar caso você esqueça a senha. A partir daí, as configurações sincronizadas do vault passam a trafegar criptografadas.
2. Criptografar o conteúdo do vault (opcional). O botão Criptografar envia novamente cada nota ao servidor de sincronização como texto cifrado. Seus arquivos locais continuam em Markdown puro, então um vault local nunca corre risco — experimente primeiro em um vault descartável. Quando o envio terminar, use Concluir migração para passar a aceitar somente texto cifrado a partir daí.
3. Em outro dispositivo, abra o mesmo vault sincronizado. O Plainva detecta que o vault está criptografado e pede a senha (ou o código de recuperação). Depois de desbloquear, as notas são descriptografadas e aparecem localmente.

A chave desbloqueada fica em cache em cada dispositivo. Ative Exigir senha a cada início para digitá-la novamente após cada reinicialização em vez disso, e use Bloquear para remover a chave em cache deste dispositivo.

Contas em todos os seus dispositivos são três etapas. 1 · Configurações e contas: coloca as configurações do cofre e suas contas (agendas, caixas de correio, seleção de agendas) em um arquivo pequeno no cofre — enquanto não houver senha configurada não é preciso nenhuma; assim que existir uma, cada dispositivo precisa inseri-la antes que as configurações viajem a partir dele. 2 · Senha de sincronização (opcional): só é necessária se os logins também devem viajar; ela criptografa ainda as configurações da etapa 1. 3 · Levar os logins: leva também as senhas estáticas de IMAP e CalDAV, criptografadas, e só pode ser ativada quando a etapa 1 estiver funcionando e a senha estiver desbloqueada — uma senha só pode chegar a uma conta que o dispositivo já conhece. Não são levados: caminhos específicos do dispositivo e logins OAuth (Microsoft, Google); seus tokens são presos ao dispositivo, então a conta aparece no novo dispositivo e lá precisa de Entrar uma vez.

No telefone você encontra a mesma cadeia na página do cofre — as mesmas três etapas e o mesmo bloqueio. Contas vindas de outro dispositivo são criadas ali; você não as digita mais à mão. Com Trazer de outro dispositivo agora você as obtém na hora, em vez de esperar a próxima rodada.

Se o Plainva avisar que uma versão antiga ainda publica dados de conta descontinuados, atualize o Plainva em todos os dispositivos que usam este vault. O dispositivo atual ignora credenciais antigas de cliente do Google e mantém o login local que funciona. Não confirme a remoção dos dados remotos antigos até que todos os dispositivos participantes tenham sido atualizados. O Plainva oferece o botão no aviso em Configurações → Vault → Sincronização → Diagnóstico: Remover entradas descontinuadas — a pergunta feita é exatamente essa confirmação.

Onde esse login acontece depende do serviço: uma caixa de correio mostra o botão Entrar neste dispositivo na própria linha, na área E-mail; uma conta de calendário ou de arquivos faz isso em Contas na nuvem. Uma caixa Microsoft sempre leva a Contas na nuvem, porque o login dela ocorre no navegador.

Se você configurar a criptografia do zero, o passo 3 já vem ligado — caso contrário, cada dispositivo adicional ficaria permanentemente sem credenciais. Em um cofre que você já usa, nada muda em silêncio: o Plainva pergunta uma vez e guarda sua resposta.

Se uma conta aparece como dois cartões, o Plainva não conseguiu buscar a identidade no provedor — e ele não deve adivinhar. Abra um dos dois em Contas na nuvem e use Mesclar para dizer que é a mesma conta; o Plainva mostra antes o que será mantido.

O que viaja e o que fica aqui

Se Revisar contas duplicadas aparecer em Contas na nuvem, o Plainva não tenta decidir pelo nome. Escolha Manter esta conta no cartão correto. A confirmação mostra destino, origens e serviços afetados e primeiro cria um backup neste dispositivo. Cancelar não altera nada. A mesclagem remove apenas contas locais, caches e credenciais órfãos — nada é excluído no provedor.

O telefone carrega um pouco menos: a disposição das quatro barras do desktop fica no computador — sua própria barra de navegação viaja, sim, assim como a pasta de reuniões. A própria cadeia dele na página do cofre mostra o que ele carrega, e os dois dispositivos dizem abaixo o que a sincronização realmente fez por último, com os nomes das configurações que viajaram e, em um recebimento, as que mudaram. O aviso “Configurações adotadas de outro dispositivo” aparece no máximo uma vez por sessão e somente se algo realmente mudou; depois disso, são estas linhas que informam. Novo nesta versão: o telefone também assume o formato do nome das notas diárias, o tipo OKF das notas novas e seus favoritos. Antes, um cofre com outro formato de data ganhava uma segunda nota diária para o mesmo dia assim que o telefone o tocava.

O diagnóstico agora separa última verificação (campos locais do perfil), último download, última aplicação e último envio real. “Enviado” só muda depois de uma gravação bem-sucedida na nuvem; rodadas sem alteração atualizam a verificação e o download, mas não o horário de envio. Os resultados de segredos aparecem separadamente como contagens de importados, inalterados, rejeitados, desatualizados, com erro ou aguardando uma conta. Eles contêm apenas códigos de motivo estáveis — nunca ID da conta, senha, token ou erro bruto. Um aviso de cliente antigo significa que o Plainva deve ser atualizado em todos os dispositivos participantes; este dispositivo ignora os dados antigos do cliente Google.

Erros e nova tentativa automática

A janela mantém a tentativa exata que falhou, mesmo quando uma nova tentativa automática já mudou o estado ao vivo. Ela informa se a tentativa está em andamento ou foi concluída. Reconectar só é recomendado para erro de autenticação; erros de rede, tempo limite e provedor mantêm os detalhes e são tentados novamente automaticamente.

Nomes que diferem apenas na grafia

O Google Drive não diferencia maiúsculas de minúsculas ao pesquisar, e o Windows e o macOS guardam Nota.md e nota.md no mesmo arquivo. Quando uma pasta contém duas notas cujos nomes diferem apenas nisso — ou apenas na forma como uma letra acentuada é escrita (ü como um caractere ou como u com trema) —, o Plainva não consegue distingui-las do outro lado. Nesse caso a sincronização não altera nem exclui nada e, em vez disso, informa um erro citando os dois nomes. Renomeie uma das duas notas e a sincronização continua.