Minha comunidade ou organização tem controle total e propriedade sobre os dados armazenados em um dispositivo EDT Offline?

Isso é verdade apenas se você estiver , pois atualmente estamos dependendo do , que oferece à equipe do Balena backdoors para qualquer dispositivo. Temos planos de migrar para o uso do , o que removerá esses backdoors para a organização Balena.

Posso instalar o EDT Offline em qualquer computador?

Sim, existem duas maneiras de instalar o EDT Offline em um computador, mas ambas requerem algum conhecimento técnico, seja formatando um computador ou executando o .

⚠️ Check out the online demo to have the browsing experience of the Offline Toolkit

📶 You see what people in WiFi range of the device will see

To start using Earth Defenders Offline Toolkit you'll need to setup a computer to run the software. If you already have one, proceed tohttps://github.com/digidem/edt-docs/blob/portuguese/introduction/broken-reference/README.md.

There are several supported devices and ways to setup computers to run the Offline Toolkit. Head to the https://github.com/digidem/edt-docs/blob/portuguese/introduction/broken-reference/README.md section to understand how this works.

If your team lacks the necessary technical skills to setup your own device, please get in touch with our team at Digital Democracy so we can assist you on choosing the best path to deploy a device for your community or organization.

The reality of many communities is that Internet connectivity is unreliable, or non existent. For that reason Earth Defenders Toolkit can be deployed to computers on the ground so that all content can live offline, in a local network, and can be synced whenever the device goes online.

A computer running EDT offline creates a hotspot, where people with devices in wifi range can download, install, and use applications curated on the Earths Defender’s Toolkit platform. We've organized content around topics such as community mapping and land-based storytelling. For each of these topics we provide guides, use cases, assets and helper applications, which are made available through a simple interface.

On the local network, community members have access to applications for storing and sharing their content. The featured tool Terrastories can also be used locally.

A interface para o Mapeo Data Hub é um mapa que exibe as observações que foram sincronizadas. Por ser algo perigoso, exibimos apenas os marcadores e nenhuma informação adicional.

Feedback é bem-vindo sobre como construir isso de forma segura e útil.

O Earth Defenders Offline Toolkit destina-se a ser usado por um grupo que possui um espaço de reunião físico comum, que é a área de cobertura do wifi do dispositivo. Essa área de cobertura pode ser pequena ou grande, dependendo do rádio wifi do dispositivo, mas pode se expandir para cobrir grandes áreas, como vilas, conectando-as a roteadores e expandindo-se por meio de redes mesh.

O Offline Toolkit tem como objetivo ajudar os grupos a integrar novos usuários às ferramentas reunidas na plataforma Earth Defenders Toolkit, além de fornecer ativos úteis comuns e aplicativos auxiliares para essas ferramentas. Ele também pode ajudar na organização de dados em um ambiente offline local e fornecer formas de sincronizar e compartilhar dados localmente ou pela Internet. É também uma ótima ferramenta para organizações parceiras se organizarem e sincronizarem dados com as comunidades locais.

Alguns dispositivos Offline Toolkit (como placas únicas de computadores) são pequenos, mas não são tão frágeis e, com uma caixa apropriada, podem ser facilmente transportados em uma mochila juntamente com roupas.

O toolkit pode ser utilizado móvel, durante reuniões ou trabalho de campo, desde que se tenha a fonte de energia e a proteção contra intempéries adequadas.

Também é ótimo para espaços internos, como uma casa, uma base remota ou um escritório, contanto que esteja protegido do tempo e de outros possíveis riscos, como crianças brincando.

Os fluxos de trabalho das ferramentas atualmente incluídas são mapeamento participativo com o Mapeo e narração de histórias baseadas em territórios com Terrastories. Esses fluxos de trabalho são destinados a:

• integrar novos usuários às ferramentas por meio de arquivos de configuração, tiles de mapa, etc.

• fornecer instaladores móveis e desktop para as ferramentas

• fornecer serviços de interligação entre as ferramentas

Even on offline environments, devices (mobile or desktop) in good range of the WiFi created by the Offline Toolkit computer will have access to:

• All content on the EDT platform: guides on community protocols and curated tools, as well as stories from communities from around the world on their experience using the tools

• Installers for curated tools

Certifique-se de ter um dispositivo que foi configurado previamente com o Earth Defenders Offline Toolkit.

Se o seu dispositivo tiver um cartão WiFi externo, conecte o cartão ao dispositivo antes de ligá-lo. Se houver antenas externas, certifique-se de conectá-las.

Conecte o dispositivo à fonte de alimentação e verifique se o dispositivo está ligado verificando se as luzes estão acesas. Se houver um cartão WiFi externo, ele também deve ligar.

Após alguns minutos, verifique se o ponto de acesso WiFi aparece nos dispositivos do usuário. Conecte-se ao ponto de acesso e abra o portal cativo (para desktops, o portal cativo pode não ser exibido).

• Github Actions

O Offline Toolkit fornece um espaço de armazenamento para dados da comunidade. Além do administrador, todo o conteúdo é público.

O primeiro passo é criar uma nova conta para você. Você precisará memorizar seu nome e senha.

Depois de fazer login, você terá acesso ao espaço público para armazenar arquivos. Crie uma pasta pessoal ou em equipe e armazene seus arquivos dentro dela.

Esteja atento ao espaço de armazenamento, pois há limites para o que o dispositivo pode suportar. Consulte para saber como verificar o espaço de armazenamento.

Um aplicativo personalizado que pode ser usado para:

• Sincronizar dados do Mapeo de dispositivos locais, veja

• Exibir todos os dados de observação em um mapa offline local, veja

Todos os usuários logados na nuvem da comunidade têm acesso a todas as pastas. Mas caso você queira compartilhar um arquivo com alguém que não faz parte da comunidade através da rede local, você pode usar a funcionalidade Compartilhar do aplicativo de navegação de arquivos.

Selecione a duração do compartilhamento e, se necessário, uma senha, e por fim clique em Compartilhar:

Copie o endereço e compartilhe por outros meios, como um aplicativo de mensagens.

Atualmente, existem 3 conjuntos de ferramentas pré-carregados e em execução:

• Mapeamento e Monitoramento

• Contação de histórias baseadas em terra

O Earth Defenders Offline Toolkit vem com uma instância do Terrastories rodando, geralmente no endereço:

Consulte a documentação oficial para obter mais informações:

A forma recomendada e mais fácil de conectar qualquer dispositivo Offline Toolkit à internet é através de um cabo Ethernet, diretamente do roteador para o dispositivo.

Apenas não conecte na porta WAN do roteador, que geralmente é azul.

Seu dispositivo pode se conectar a um ponto de acesso WiFi local para obter acesso à internet, mas essa função ainda não foi bem testada.

Para testá-la, vá para o painel de administração e vá para a aba Rede, geralmente localizada em:

O dispositivo irá procurar por pontos de acesso WiFi próximos. Em seguida, você pode selecionar aquele a que deseja se conectar, inserir a senha e conectar-se.

Personalização

Seu projeto pode já ter uma chave secreta configurada e, portanto, seu dispositivo Mapeo não consegue encontrar o Mapeo Hub localmente.

Verifique customizando-experiencia.md para obter instruções sobre como alterar as variáveis.

Você pode alterar a chave do projeto para o Mapeo: MAPEO_PROJECT_KEY

Adicione a chave do seu projeto, que pode ser obtida na tela de sincronização do Mapeo.

Altere a categoria do Mapeo onde os lugares do Terrastories serão coletados: MAPEO_TERRASTORIES_TYPE

Todas as observações dessa categoria serão incluídas no arquivo csv com os lugares da história para importar no Terrastories.

Uma interface simples é fornecida para fazer o download de instaladores para diferentes aplicativos. Ela está localmente endereçada em: http://edt.local:8080/apps

Instaladores estão disponíveis para todos os principais sistemas: Android, iOS, Windows, Mac e Linux.

Se o instalador não estiver disponível para o seu sistema, é porque ele não existe.

The Offline Toolkit comes with an administrator interface that's usually located at: http://edt.local:8079/

With it it's possible to:

• Check device name

• Check RAM and CPU usage

• Check other various information relatede to your device

• Restart or shutdown the device

• Manage running services

• Explore files similar to Filebrowser

• Connect to a WiFi hotspot

• Set custom variables

Get in touch with us for Support.

Write to us at [email protected] or go through our inquiry form which can help us find out more about your needs.

For additional support, please check out the community of active users and maintainers of the Earth Defenders Toolkit on our public Discord, Telegram group and online forum.

No arquivo de configuração incluso com o Offline Toolkit há uma categoria Terrastories. Toda observação marcada com ela será processada pelo Mapeo Data Hub e colocada em um arquivo csv formatado para Terrastories.

Uma vez importadas para o Terrastories, as observações estarão disponíveis como Lugares e prontas para serem usadas para vincular a Histórias e Oradores.

• Balena: OS, Cloud

A Nuvem da Ferramenta dos Defensores da Terra é uma infraestrutura em forma de código projetada para ser usada pela equipe de projetos da Democracia Digital, assim como ser replicada por outras organizações que prestam apoio às comunidades.

O objetivo desses servidores é inicializar e atualizar o conteúdo para instâncias offline da Ferramenta dos Defensores da Terra, sendo que eles têm alta disponibilidade.

• https://github.com/digidem/edt-cloud

• https://github.com/digidem/edt-offline-portal

• https://github.com/digidem/edt-offline

• (WIP)

• (WIP)

Com o aplicativo Filebrowser integrado, os membros da comunidade podem criar suas próprias contas, fazer upload e download de arquivos de um espaço digital compartilhado.

Um administrador pode gerenciar usuários, diferentes configurações e ter conteúdo privado.

O nome de usuário padrão é admin e a senha é admin123.

Verifique os guias em:

Para sincronizar conteúdo entre diferentes dispositivos online ou offline, verifique a documentação em .

O Earth Defenders Toolkit Offline vem com uma instância do Syncthing rodando, geralmente no endereço: http://edt.local:8082

O nome de usuário padrão é admin e a senha é admin123.

Na primeira vez que um dispositivo é conectado, ele enviará uma solicitação para a Nuvem do Earth Defenders Toolkit para iniciar a sincronização do conteúdo. Obtenha o ID da instância local do Syncthing no Offline Toolkit:

Entre em contato conosco em support.md e envie seu ID do Syncthing juntamente com outras informações.

Assim que autorizarmos a sincronização pela Nuvem do EDT, o Offline Toolkit local começará a mostrar informações de sincronização:

A sincronização pode levar um tempo porque é alguns gigabytes de conteúdo. Depois disso, todo o conteúdo estará pronto para uso offline.

Mapeo Data Hub

É um aplicativo personalizado feito para a Offline Toolkit que tem a intenção de possibilitar a integração de conteúdo do Mapeo com o Terrastories, além de oferecer uma experiência melhor para os usuários do Mapeo.

Uma instância do aplicativo de Ahau.

Uma instância do aplicativo .

Uma instância do aplicativo .

Uma instância do aplicativo que já está pré-configurado para enviar solicitações de sincronização para as pastas de conteúdo na nuvem oficial da EDT.

Ele pode ser personalizado para sincronizar outras pastas por padrão ou usado para sincronizar qualquer pasta no dispositivo. Também existem aplicativos móveis e desktop para sincronizar com qualquer dispositivo facilmente.

Um aplicativo simples e personalizado que exibe os instaladores para os aplicativos selecionados.

Uma instância de .

You'll need any computer with an Operaying System that can run Docker & docker-compose. You might need someone with technical skills on these tools to set it up.

Using Docker EDT-Offline can be setup in almost any machine without any special operating system needed.

Needed installed software

• Docker

These are the steps:

1. Clone repository

2. cd docker/local directory

3. cp .env.example .env

Primeiro, conecte-se ao ponto de acesso WiFi da Offline Toolkit, ou a uma rede WiFi à qual também esteja conectado.

Abra o Mapeo e acesse a página de sincronização. Consulte a documentação sobre sincronização do Mapeo.

Você verá o dispositivo Offline Toolkit aparecendo e pronto para sincronizar.

Caso contrário, você pode precisar alterar a chave do projeto. Caso não tenha um projeto existente, faça o download e use a configuração personalizada do Mapeo que é fornecida, pré-configurada com a mesma chave do projeto do Hub.

Se você já tem uma chave de projeto personalizada, consulte Customization para aprender como definir a chave correta para o Mapeo Data Hub funcionar para a sua equipe.

Leia mais sobre chaves de projeto .

⚠️ Beware that during Beta we're relying on the service Balena Cloud by a company, and they have back doors to all devices.

The process for preparing a device to run Earth Defenders Offline Toolkit requires a notebook or desktop computer, used to "burn" images to sd cards or usb flash drives. So basic skills on using them is required.

For help with common technical issues, see the section of this guide. For additional help, see the section.

Às vezes, queremos manter os dados sincronizados entre dispositivos, como ter documentos compartilhados em diferentes dispositivos e por todas as pessoas de uma equipe. Para isso, usamos a mesma aplicação usada para , o Syncthing. Geralmente, ele está em execução no endereço:

Podemos começar adicionando uma pasta de nossa nuvem comunitária:

Adicione um rótulo descritivo para a nova pasta. O diretório do conteúdo é chamado /config aqui, então encontre sua pasta nele.

Antes de clicar em salvar, vá para a guia Avançado. Altere o Tipo de Pasta

The process for a single-board-computer (SBC) is much simpler, and only requires burning an sd card.

Recomended devices:

O Earth Defenders Offline Toolkit vem com uma instância do Pataka do Āhau em execução, geralmente no endereço:

Pataka é um aplicativo projetado para ser executado como um peer sempre online. Idealmente, esse peer é configurado com um endereço IP estático e público (ou redirecionamento de porta de um).

Este peer não é capaz de descriptografar mensagens (ou arquivo) que são privadas para grupos, mas replicará essas mensagens (e arquivos) para garantir que estejam acessíveis mesmo quando o criador está offline ou para que haja um backup.

Consulte o site oficial por enquanto:

• What's Balena

Third party company will be managing a monitoring platform for your devices, and they have backdoors to your devices

You'll need some software to burn images to a storage device (pen drive or sd card), we recommend Balena Etcher.

Anyone can deploy there own EDT-Offline by following these steps:

1. Click on "Deploy with Balena”

2. You'll be asked to create a Balena Cloud account

3. You'll be prompted to deploy a new fleet, change the name if necessary and click on "create and deploy”

4. Click on the "Add device” button

5. Leave in "Production" mode unless you'd like to experiment and have ssh access to the device

6. To setup the device you'll need Internet, choose the way you intend to connect, either through WiFi (provide the credentials) or Ethernet cable

7. Finally either click "Flash" which will automatically flash using Etcher, or using the arrow click on "Download balenaOS", which will download the image file

8. Insert the storage in the computer and burn the image

9. Finally insert the storage to the device and watch your , a new device should appear and start updating it's software

10. To sync with default content you'll need to get in touch with us through e-mail, Telegram or Whatsapp

Change your device location on the Balena Cloud “Location” tab. This is recommended if you don’t want your device to be found on the .

⚠️ Attention! The administration interface can only work while the device is connected to the internet for now.

The adminstration interface there's a configurations page that can be used to customize the Offline Toolkit. That page is usually found at:

On the initial page there's several information on the devices's usage: processing, memory, storage as well as other importante information such as cpu temperature. Select the menu to explore other functionality.

In order to customize the device, enter the Configuration page:

1. Web scraping

A raspagem de sites é feita pelo comando na linha de comando. Encontre mais instruções na .

Algumas experimentações são necessárias para encontrar as melhores práticas sobre como obter exatamente a quantidade de páginas que desejamos raspar e para cada idioma.

A raspagem pode levar muito tempo. Use os arquivos warcz de saída na próxima etapa.

On regular machines the process is similar to formatting any computer. It's done through flashing a usb drive and getting it to boot through keyboard commands.

Recomended devices:

Syncthing

Uma aplicação de sincronização de arquivos peer-to-peer, gratuita e de código aberto, disponível para a maioria das plataformas. Ela pode sincronizar arquivos entre dispositivos em uma rede local ou entre dispositivos remotos pela internet. A segurança e a integridade dos dados são incorporadas ao design do software. É uma alternativa de código aberto ao Resilio Sync.

O aplicativo é usado para manter o conteúdo atualizado (configurações e imagens do mapeo, sites offline, repositório f-droid, etc) disponível quando os dispositivos da comunidade ou da organização estiverem online.

O primeiro handshake entre a instância na nuvem e outros dispositivos é iniciado automaticamente pelo dispositivo EDT Offline, mas precisa ser aceito por alguém com acesso ao serviço de nuvem.

File Browser

Fornece uma interface de gerenciamento de arquivos dentro de um diretório especificado e pode ser usado para enviar, excluir, visualizar, renomear e editar arquivos. Ele permite a criação de vários usuários e cada usuário pode ter seu próprio diretório. Pode ser usado como um aplicativo independente. É uma alternativa de código aberto ao Google Drive, sem os conjuntos de escritório.****

É usado para navegar no conteúdo tanto na nuvem quanto no dispositivo offline. A equipe que dá suporte às comunidades deve usá-lo para adicionar ou remover conteúdo hospedado na nuvem. Os dispositivos offline podem usá-lo para compartilhar arquivos com a equipe de suporte ou dentro da rede local.

Repositório F-Droid

O F-Droid é uma loja de aplicativos e um repositório de software para Android. Os aplicativos podem ser navegados, baixados e instalados pelo aplicativo cliente sem a necessidade de se cadastrar em uma conta. É uma alternativa de código aberto à Google Play Store.

Nós fizemos um fork de um aplicativo cliente e criamos nosso próprio cliente , que vem com nosso próprio repositório , além do repositório que está rodando nos dispositivos EDT Offline.Regular clientes F-Droid também podem usar o repositório EDT adicionando simplesmente a URL à sua lista de repositórios ou escaneando o código QR apresentado.

Sala Secure Scuttlebut

O aplicativo principal, , é uma rede social sem coisas ruins, construída no protocolo SSB ponto a ponto. É gratuito e de código aberto, disponível para desktop e mobile. Não está executando na nuvem de uma empresa, em vez disso, todos os dados vivem completamente nos dispositivos dos usuários. Desta forma, mesmo quando offline, os usuários podem rolar, ler qualquer coisa e até mesmo escrever posts e curtir conteúdo. Quando o dispositivo está de volta online, ele sincroniza as últimas atualizações diretamente com outros dispositivos, através de uma rede Wi-Fi local compartilhada ou na internet.

A Sala SSB é um serviço que permite que pares "se encontrem" online e troquem dados. Ao executar nossa própria Sala, podemos conectar parceiros entre si e também apoiar equipes. Tem recursos de gerenciamento de usuários (listas de permissões e negações + funções de moderador e administrador), tudo administrado através do painel da web.

Armazenamento Minio

MinIO é uma solução de armazenamento de objetos de alto desempenho que oferece uma API compatível com o Amazon Web Services S3 e suporta todos os recursos principais do S3. É uma alternativa de código aberto ao Amazon S3.

É usado para organizar os dados do Terrastories em buckets. Dessa forma, se um parceiro quiser ter o seu Terrastories publicado na nuvem, podemos sincronizar o bucket do Minio dele, que está sendo executado no dispositivo EDT Offline, e executar uma instância do Terrastories na nuvem puxando esses dados. Isso fornece uma maneira organizada de manter instâncias do Terrastories online e offline em sincronia.

Tunneling to a development device

In order to make it easier to debug and do QA testing on a feature or a release, it's helpful to expose the virtual device's services. We can use tailscale for that.

SSH into the virtual Balena device using the UUID which can be obtained from the Balena dashboard:

balena ssh <uuid>

Within the virtual Balena environment, run:

And to start the tailscale service, run:

The Tailscale container will provide you a URL to access that adds the device to your Tailscale account.

Then from your Tailscale admin panel to be able to use all the devices locally through the IP addresses they are assigned by Balena Virt.

On your own machine run:

And to start tailscale:

Don't forget to also enable the subnets. And now on your machine you should be able to access services on the balena device's ip.

Using remote device

In order for Terrastories and the offline map on both Terrastories and Observations Map to work remotely you'll need to set the device's variables to use the tunneled ip:

• HOST_HOSTNAME ex.: 100.96.14.113

• OFFLINE_MAP_STYLE ex.: http://100.96.14.113:8085/styles/terrastories-map/style.json

Setting up a virtual-machine

Read details on the .

Make sure you have a Balena Fleet with generic x86_64 (GPT) as the Default device type.

On a Digital Ocean droplet with at least 25Gbs of storage and 1Gb of ram, and latest Docker pre-installed, run:

After a few seconds a new device should appear on your amd64 and should start updating itself with latest release for the Fleet.

There are a multitude of different boards that can be used to run EDT Offline. From recycled hardware, such as old computers to tiny, low-power single-board-computers.

Raspberry Pi 4, Rock Pi 4, ZimaBoard

Some important things to pay attention when choosing the right device:

• Ease to setup (single-board-computers are always easier)

• Price, including power supply, storage, case, etc.

• WiFi range and capacity

• Energy usage

• Power

• Availability

• Form factor

Easiest to setup, but more expensive and less CPU and WiFi power

Single-board-computers are the easiest to setup. We’ve tested on the Raspberry Pi 4 and Rock Pi 4, and had great results. The Raspberry 3 should be able to handle as well, but we haven’t tested yet.

For all these boards it's a question of downloading the latest release from the , and burning them to an class 10 micr-sdcard using a software such as .

Recommended: Rock Pi 4 B+

We recommend the board because of the chip shortages around the globe resulting in a scarcity of the Raspberry Pi boards.

Besides the board itself you’ll need some cooling, as the boards tend to overheat without appropriate cooling system.

You’ll also need a power supply in case it isn’t included with the board, and it’s important that it’s a USB C 5v with at least 3A.

And finally you’ll need a storage, which should be at least class 10 micro-sd card.

Buying from Amazon:

Cheap, powerful CPU and WiFi, but harder to setup

Any old desktop of notebook can serve as an EDT Offline device, but they’re a bit harder to setup, and they usually require entering the computer’s BIOS and change some settings to set USB as primary device to boot from. That will require are least a key board and a screen, and appropriate cables to connect to it.

After changing the BIOS settings, you’ll need to burn the amd64 image from the , and burn it to a thumb drive with enough storage.

Turn the device off, insert the thumb drive, and turn it back on. This process can take minutes and might require a few restarts, but once finished will have a fully working EDT Offline instance.

If you’re buying a computer to use with EDT Offline, we recommend mini-pcs such as the .

Recommended:

It’s one of the cheapest boards you can get, with the smallest form-factor. It’s PCI express port makes it easy to plug different WiFi adapters, which will depend on how fast you want the connection to be, how many people it can handle at the same time and how far you need your WiFi hotspot to go.

Buying from Amazon

Full list of potential devices

Single Board Computers

Because they usually use ARM cpus they tend to be consume less energy and have a smaller form-factor, but are less capable, and don't usually include storage, casing or a cooling system

• (~90 USD) 🇺🇸

  • 4GB LPDDR4

  • RK3399 Hexa-Core

Fanless Mini PCs

These tend to be cheaper and more powerful then SBCs, and come complete with storage, casing and power supply

• (~120 USD) 🇺🇸

  • 8GB DDR3

  • 128GB SSD

O Earth Defenders Offline Toolkit vem com uma instância do Pataka de Āhau em execução, normalmente no endereço:

As configurações podem ser alteradas usando o aplicativo FileBrowser, dentro do diretório mbtiles. Localmente, ele pode ser acessado em: .

O software pode ser usado para baixar os tiles do mapa, e o sobre como fazer isso.

Consulte o site oficial por enquanto: