APP Reitti: Linha do Tempo dos Seus Deslocamentos em Servidor Próprio
O Que Você Precisa Saber
O Reitti é um programa que registra os lugares por onde uma pessoa passa, desenha os trajetos em um mapa e calcula estatísticas. O usuário instala o programa em um servidor próprio, usando Docker Compose. A versão mais recente, a 5.8.1, foi lançada em 24 de outubro.
O Que É o Reitti
"Reitti" vem do finlandês e significa "rota" ou "caminho". Segundo a documentação oficial, o programa transforma dados do Sistema de Posicionamento Global [GPS] em informações sobre deslocamentos, visitas e lugares importantes. Daniel Graf assina a documentação.
A licença é a GNU Affero General Public License v3.0 [AGPL-3.0]. Em 28 de outubro de 2026, o repositório somava 2,6 mil estrelas no GitHub. Estrelas são marcações de favorito feitas por usuários da plataforma.
Quais São as Funções
[1] Linha do tempo diária: mostra visitas e trajetos, com duração e distância.
[2] Detecção de visitas e trajetos: identifica os locais de permanência e o meio de transporte [a pé, bicicleta ou carro].
[3] Lugares significativos: o usuário dá nome aos locais que visita com frequência.
[4] Trilhas de GPS: exibem o caminho completo percorrido.
[5] Visão de múltiplos usuários: mostra familiares e amigos em um único mapa.
[6] Modo ao vivo: novos dados aparecem no mapa sem recarregar a página. A tela cheia transforma o mapa em painel de exibição contínua.
[7] Compartilhamento ao vivo: funciona entre usuários da mesma instalação, entre instalações diferentes [federação] e por link mágico.
[8] Bancada de trabalho [Workbench]: o usuário arrasta pontos de GPS errados para o lugar correto. A bancada também remove pontos fora do padrão e une dados de aparelhos diferentes.
[9] Estilos de mapa: o usuário envia arquivos de estilo ou indica provedores de mapas, como MapTiler e Stadia Maps.
[10] Fotos: a integração com o servidor Immich mostra, na linha do tempo, as fotos tiradas em cada local.
[11] Estatísticas: gráficos de distância, lugares mais visitados e divisão por meio de transporte.
[12] Memórias: diários de viagem com blocos de texto, mapas e imagens, que o usuário edita e compartilha.
Como Fica a Privacidade
O arquivo de apresentação do projeto [README] afirma que os dados de localização ficam no servidor do usuário.
[1] O compartilhamento ao vivo envia a posição atual apenas a usuários e instalações que o usuário autoriza.
[2] O usuário pode revogar um link mágico a qualquer momento.
[3] A instalação aceita múltiplos usuários, com dados isolados por conta.
[4] A instalação aceita login único via OpenID Connect [OIDC].
[5] A conversão de coordenadas em endereço usa, por padrão, instâncias hospedadas do projeto Paikka. O usuário pode configurar um geocodificador próprio.
Como Instalar
[1] Crie a pasta do programa:
mkdir reitti && cd reitti.[2] Baixe o arquivo de configuração:
wget https://raw.githubusercontent.com/dedicatedcode/reitti/refs/heads/main/docker-compose.yml.[3] Inicie os serviços:
docker compose up -d.[4] Abra
http://localhost:8080no navegador.[5] Defina a nova senha de administrador no primeiro acesso. O sistema cria um token de interface de programação [token de API] padrão, pronto para conectar aparelhos.
Computadores com processador ARM64 [como os Macs com chip Apple] exigem uma troca. No arquivo de configuração, substitua a imagem do PostGIS por imresamu/postgis:17-3.5-alpine. A troca vale até a solução do problema 216 do repositório postgis/docker-postgis.
Como Enviar Dados ao Reitti
O guia de importação de dados detalha cada formato.
Fontes de dados aceitas pelo Reitti e forma de envio | |
Fonte | Forma de Envio |
|---|---|
GPX | Arquivo |
Google Takeout JSON | Arquivo |
Google Timeline Export | Arquivo |
GeoJSON | Arquivo |
OwnTracks | Tempo real |
GPSLogger | Tempo real |
Overland | Tempo real |
Home Assistant | Tempo real |
API REST | Programa do usuário |
Qual Versão Instalar
O projeto publica cinco tags de imagem Docker. Tag é a etiqueta que identifica uma versão da imagem.
Tags de imagem Docker do Reitti, estabilidade e uso | ||
Tag | Estabilidade | Uso |
|---|---|---|
| Estável | Última versão estável publicada, incluindo troca de versão maior. |
| Estável | Última versão da série 5.x, com correções e recursos novos e sem troca de versão maior. |
| Estável | Versão fixa, para implantação reproduzível. O número é o exemplo do README. |
| Em desenvolvimento | Reconstruída a cada alteração na ramificação principal. Pode apresentar falhas. |
| Alfa | Próxima versão maior em desenvolvimento. Fora de produção. |
O README recomenda a tag 5 para a maioria dos usuários. A tag next pode alterar o esquema do banco de dados de modo incompatível, com risco de corrupção ou perda de dados.
Cópia de Segurança
[1] Faça cópias regulares do banco de dados PostGIS.
[2] Faça cópias regulares do volume de armazenamento do Reitti, que armazena os arquivos enviados.
O Redis e os demais serviços sem estado dispensam backup. O guia de backup traz o procedimento.
Novidades da Versão 5.8.1
A versão 5.8.1 corrige um erro na Bancada de trabalho. O erro surgiu após a atualização do Spring Boot para a versão 4.0. O sistema passou a ler com falha os campos de início e de fim e adotava o ano de 1970. O encaixe de um aparelho na linha do tempo gerava um período vazio. A versão também completa a tradução para o francês da página de estatísticas, criada na versão 5.8.0.
Suporte e Contribuição
[1] Abra uma solicitação de suporte no GitHub.
[2] Marque @danielgraf no Lemmy.
[3] Entre no canal #reitti no libera.chat.
O projeto aceita contribuições via pull request. A tradução do programa ocorre na plataforma Weblate.
Glossário de Termos
AGPL-3.0
Licença de software, versão 3.0 da GNU Affero General Public License.
API
Interface pela qual programas trocam dados.
Docker Compose
Ferramenta que inicia vários serviços a partir de um arquivo de configuração.
Federação
Conexão entre instalações independentes do Reitti.
Geocodificação Reversa
Conversão de coordenadas geográficas em endereço.
GeoJSON
Formato de arquivo para dados geográficos.
GPX
Formato de arquivo para trilhas de GPS.
Immich
Servidor próprio de fotos.
JSON
Formato de arquivo de texto para dados estruturados.
Link Mágico
Endereço da web que dá acesso à posição ao vivo de um usuário, sem conta na instalação.
OIDC
Sigla de OpenID Connect, protocolo de login único.
PostGIS
Extensão geográfica do banco de dados PostgreSQL.
Redis
Banco de dados que armazena informações em memória.
REST
Estilo de API que troca dados pela web.
Token de API
Código secreto que identifica um aparelho ou programa perante o Reitti.
Referências Bibliográficas
DEDICATEDCODE. Reitti. GitHub, [s.d.]. Disponível em: https://github.com/dedicatedcode/reitti. Acesso em: 28 out. 2026.
DEDICATEDCODE. Reitti v5.8.1. GitHub, [s.d.]. Disponível em: https://github.com/dedicatedcode/reitti/releases/tag/v5.8.1. Acesso em: 28 out. 2026.
GRAF, Daniel. Reitti Documentation: Overview. [S.l.]: dedicatedcode, [s.d.]. Disponível em: https://www.dedicatedcode.com/projects/reitti/latest/. Acesso em: 28 out. 2026.