Como instalar o Baikal na Saplo: o teu próprio calendário e contactos

O calendário no teu telefone mostra outras datas do que no teu computador, e depois de mudar de dispositivo tens que mover os contactos novamente. Baikal permite-te recolher esses dados no teu próprio servidor e sincronizá-los com as aplicações que já usas. Neste tutorial, vamos mostrar como configurar o Baikal na Saplo, criar um utilizador e verificar a sincronização do calendário e do livro de endereços.

O que te dá o teu próprio Baikal

Baikal, escrito pelos seus autores como Baïkal, é um servidor CalDAV e CardDAV leve. CalDAV é usado para sincronizar calendários, e CardDAV para contactos. O Painel no navegador permite-te gerir utilizadores, calendários e catálogos de endereços. Adicionar reuniões ou números de telefone diariamente é feito no programa cliente conectado.

O projeto suporta clientes no iOS e macOS, DAVx5 no Android, e Thunderbird, entre outros. Uma descrição das funcionalidades pode ser encontrada no site oficial do Baïkal. Ao escolheres um programa, verifica o suporte para ambos os protocolos se quiseres sincronizar eventos e contactos.

Requisitos e alojamento Baikal na Saplo

O plano mais barato que cumpre os requisitos mínimos da receita é o Box S por 27 € anuais. A receita exige um mínimo de 256 MB de RAM e 2 GB de espaço em disco. Se outras aplicações já estiverem a ser executadas no mesmo Box, verifica os recursos disponíveis antes da instalação.

Prepara um Box ativo, o nome da aplicação e o endereço onde irá funcionar. Podes começar com um subdomínio *.saploapp.pl. A instalação a partir do catálogo e a configuração no navegador não exigem SSH. Os detalhes do serviço podem ser encontrados na página de alojamento Baikal na Saplo.

Instalação passo a passo

1. Inicia sessão no Painel Saplo, abre o Catálogo de aplicações e pesquisa por Baikal.
2. Dá um nome à aplicação, escolhe uma Box e um endereço de aplicação disponível.
3. Confirma a instalação. A Saplo irá iniciar a aplicação e preparar o acesso através do domínio com um certificado SSL.
4. Espera que a instalação termine no Painel. O tempo depende, entre outros fatores, do download da imagem e da carga do servidor.
5. Abre o endereço da aplicação via HTTPS e vai para o caminho /admin/, por exemplo, https://your-app.saploapp.pl/admin/. Substitui o domínio de exemplo pelo endereço mostrado no Painel.
6. De imediato, usa o assistente de configuração do Baikal para definir uma palavra-passe de administrador forte e única. Guarda-a num gestor de palavras-passe.
7. Na configuração da base de dados, mantém SQLite e conclui o assistente. Não precisas de encomendar ou configurar uma base de dados separada no Painel Saplo.

A receita Saplo prepara um local permanente para a configuração e os dados da aplicação, mas não gera uma palavra-passe de administrador pronta. Tu defines a palavra-passe quando acedes pela primeira vez. A instalação concluída no Painel Saplo significa que a aplicação está pronta para esta configuração, e não que as contas de utilizador já foram criadas.

Primeiro utilizador, calendário e livro de endereços

Após concluíres o assistente, inicia sessão no painel de administração do Baikal. Na secção de gestão de utilizadores, adiciona a pessoa cujos dados queres sincronizar. Define um nome de utilizador e uma palavra-passe separada e guarda-os em segurança. A conta de administrador serve para gerir o servidor; nas aplicações de calendário e contactos, usa os dados do utilizador que criaste.

Abre as definições desse utilizador e verifica a lista de calendários e livros de endereços. Se os itens necessários não existirem, cria o calendário “Pessoal” e o livro “Contactos”. Para cada nova pessoa, cria um utilizador separado, em vez de partilhar o mesmo nome de utilizador com todos.

Ligar o telefone e o computador

Para configurar o cliente, prepara o endereço do servidor via HTTPS, o nome de utilizador Baikal e a respetiva palavra-passe. O ponto de entrada dos protocolos DAV é /dav.php/, por exemplo, https://your-app.saploapp.pl/dav.php/. O caminho /admin/ é usado para administração e não é um endereço de sincronização. A configuração do ponto DAV é descrita na documentação de instalação do Baïkal.

No programa CalDAV, adiciona um calendário de rede ou uma conta CalDAV, fornece o endereço do servidor e os detalhes do utilizador e, em seguida, seleciona o calendário detetado. Para contactos, adiciona uma conta CardDAV ou um livro de endereços remoto. Os nomes dos campos dependem do programa e da sua versão; se o cliente exigir o endereço de um calendário específico, usa o endereço dessa coleção da tua instalação em vez de adivinhar o nome.

No Android, podes usar o DAVx5 como uma camada de sincronização. Adiciona uma conta com o endereço do servidor e os detalhes do utilizador, seleciona os recursos detetados e permite o acesso ao calendário e aos contactos. No iPhone ou Mac, adiciona as contas CalDAV e CardDAV apropriadas nas configurações da conta. No Thunderbird, configura o calendário de rede e o livro de endereços CardDAV separadamente.

Verificar a sincronização antes de mover os dados

Antes de importares o arquivo, faz um pequeno teste:

1. No primeiro dispositivo, adiciona um evento "Teste Baikal". Grava-o no calendário Baikal, não no calendário local do telefone.
2. Inicia a sincronização no segundo dispositivo. Verifica o título, a hora e o fuso horário do evento.
3. Altera a hora no segundo dispositivo e verifica se a alteração voltou para o primeiro.
4. Adiciona um contacto de exemplo ao livro CardDAV e verifica se aparece em ambos os dispositivos.
5. Elimina os dados de teste e confirma que a eliminação também foi sincronizada.

Ao mover dados existentes, primeiro exporta uma cópia do programa atual. Importa uma pequena amostra para o calendário ou livro de Baikal de destino, se o teu cliente fornecer essa funcionalidade. Verifica os caracteres polacos, eventos repetidos e números de telefone antes de mover tudo. Desta forma, evitarás a duplicação em massa de contactos.

O que verificar quando a sincronização não funciona

O programa rejeita o login ou a palavra-passe. Verifica se estás a usar a conta de utilizador Baikal, e não a conta do painel Saplo ou a palavra-passe de administrador. Verifica também o endereço HTTPS completo.

O login funciona, mas não consegues ver eventos. Verifica se o cliente tem o calendário correto selecionado para sincronização e se estás a guardar novas entradas no mesmo. Analogamente, verifica o livro de endereços de destino ao adicionar contactos.

O cliente não deteta o servidor automaticamente. Tenta introduzir o endereço completo com /dav.php/. A deteção automática também depende dos redirecionamentos /.well-known/caldav e /.well-known/carddav, descritos na Documentação de resolução de problemas Baikal. Se o problema persistir, informa o Suporte Saplo do endereço da aplicação, do nome do cliente e da mensagem de erro, sem enviar a palavra-passe.

A aplicação não responde após a instalação. Verifica o seu Estado no painel Saplo e o endereço que estás a abrir. Reporta a mensagem visível ao Suporte, em vez de eliminar a instalação que já contém dados.

Cópias de segurança e utilização posterior

A sincronização também transfere erros e eliminações, por isso não substitui uma cópia de segurança. O Box S não inclui backup no preço do plano. Guarda as exportações de calendários e contactos fora da Box, e antes de uma atualização, faz também uma cópia da base de dados SQLite e da configuração do Baikal. As exportações de dados do utilizador e uma cópia completa da instalação servem para diferentes métodos de recuperação.

Para começar, basta um utilizador, um calendário e um livro de endereços. Abre a oferta Baikal na Saplo, executa a aplicação no Box S por 27 € anualmente e verifica a sincronização em dois dispositivos antes de transferir os dados diários.