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.

Um aplicativo personalizado que pode ser usado para:

• Sincronizar dados do Mapeo de dispositivos locais, veja sincronizando-com-hub.md

• Exibir todos os dados de observação em um mapa offline local, veja mapas-de-observacao.md

• Gerar um arquivo csv compatível que possa ser importado para Terrastories como um Story Place, veja observacoes-do-mapeo-como-locais-do-terrastories.md

Problemas podem ser reportados no Github.

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.

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).

Por fim, com o portal aberto, copie a URL fornecida, abra seu navegador preferido, cole a URL e carregue a página. Você está pronto para começar a explorar.

Se algum conteúdo não estiver aparecendo, pode ser que o seu dispositivo ainda não tenha sincronizado o conteúdo. Para sincronizar o conteúdo com o Earth Defenders Toolkit Cloud, você deve primeiro conectar o dispositivo à Internet e, em seguida, entrar em contato conosco para obter autorização.

Para obter instruções detalhadas, consulte o manual:

Continue com os guias sobre:

• ".

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

• fornecer documentação e casos de uso para as ferramentas

• fornecer instâncias em execução das ferramentas, como Mapeo e Terrastories

• fornecer armazenamento local para dados de organização (documentos, fotos, vídeos, pastas, etc.)

• fornecer sincronização ponto a ponto dos dados armazenados, local ou remotamente

• fornecer uma maneira de atualizar todo o conteúdo sempre que o dispositivo estiver conectado à Internet.

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.

Pataka

Uma instância do aplicativo Pataka de Ahau.

Terrastories

Uma instância do aplicativo Terrastories.

File management

Uma instância do aplicativo FileBrowser.

Content syncronization

Uma instância do aplicativo Syncthing 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.

Application installers

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

Tile server

Uma instância de Tileserver.

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

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: https://ahau.io/technology.html

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.

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

• A Terrastories instance

• A Mapeo instance to sync with

• An interactive map showing Mapeo observations that have been synced with device

• File browsing application for storing and sharing files, similar to Google Drive

• Syncing of content, from EDT Cloud to local computer, or from local computer to any other device, including mobile devices, locally or through the Internet

• Automatic syncing of default content (scrapped websites, application installers, Mapeo configs, map tiles)

• Automatic creation of files that can be imported into Terrastories, from synced Mapeo observations

• What's Balena

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

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

O software QGIS pode ser usado para baixar os tiles do mapa, e o Mapeo tem uma ótima documentação sobre como fazer isso.

Consulte o site oficial por enquanto: http://tileserver.org

⚠️ 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.

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

• Mapeamento e Monitoramento

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

• Nuvem da Comunidade Local

Cada conjunto de ferramentas possui links ou downloads para os aplicativos, bem como documentação e histórias da comunidade sobre o uso das ferramentas.

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.

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:

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 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.

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.

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.

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.

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.

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 aqui.

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

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.

Get in touch with us for Support.

• Balena: OS, Cloud

À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 sincronização de conteúdo.md, o Syncthing. Geralmente, ele está em execução no endereço: http://edt.local:8082

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 de acordo com suas necessidades.

Para a nuvem, vale a pena selecionar Enviar apenas, pois na maioria das vezes queremos ter uma única fonte da verdade para o conteúdo.

Por fim, podemos clicar em salvar.

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

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 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.

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

Recomended devices:

Needed hardware

• Any of

• Class 10 micro sd card with at least 32gb

• A computer with a sd card reader

• Internet connection through ethernet cable

Needed software

• Image burner, recommended:

Preparing USB flash drive

Download the appropriate image for your device:

Use the image burner to burn the image to the sd card.

Installing the Offline Toolkit

• Insert the flashed sd card into the computer

• Insert the ethernet cable with Internet coming from your router into the computer

• Check the for the device to come online, or check if a new WiFi hotspot has appeared

You'll need any computer with an Operaying System that can run & . 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

These are the steps:

1. Clone repository

2. cd docker/local directory

3. cp .env.example .env

4. Edit .env with your own values

5. Run docker-compose up -d

6. Use docker-compose logs -f to see logs

• Github Actions

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 .

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 Balena Cloud Dashboard, 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 Balena Hub.

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 EDT Apps, que vem com nosso próprio repositório EDT app repository, 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, Manyverse, é 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.

1. Web scraping

A raspagem de sites é feita pelo comando browsertrix-crawler na linha de comando. Encontre mais instruções na documentação de raspagem.

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.

2. Carregar para a nuvem

Acesse o serviço do FileBrowser na nuvem do EDT.

Existem diferentes diretórios dentro do diretório content, cada um para um tipo de conteúdo: dados do repositório F-Droid; instaladores para desktop; dados do Mapeo (configurações e tiles); e websites offline.

Crie uma nova pasta para o novo conteúdo, se necessário:

Certifique-se de que há espaço de armazenamento suficiente no servidor e para carregar novo conteúdo basta arrastar para a pasta ou usar o ícone de upload para selecionar o arquivo no seu computador:

Assim que o novo conteúdo for carregado, podemos sincronizá-lo nos dispositivos do EDT.

3. Sincronize

Acesse o serviço Syncthing na nuvem do EDT e siga os mesmos passos como em content-syncronization.md.

4. Adicionar ao dispositivo

Verifique as instruções em syncing-content.md sobre como começar a sincronizar com um novo dispositivo. Você aprenderá como obter seu ID do Syncthing.

Na instância do EDT Cloud, pesquise por esse ID:

Dê um nome descritivo ao novo dispositivo e vá para a página de Compartilhamento.

Na página Compartilhamento selecione todas as pastas relevantes para o novo dispositivo, geralmente as defautls:

No EDT Cloud você deve ver que o dispositivo está começando a sincronizar:

Na Offline Toolkit local você também deve ver a sincronização acontecendo com mais detalhes, como taxa de download e quantidade sincronizada até agora.

Pronto. Agora, toda vez que a nuvem atualizar a pasta de conteúdo, os dispositivos Offline Toolkit sincronizarão automaticamente sempre que estiverem online.

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:

Needed hardware

• Any spare computer with a storage that you can format, like old desktop or laptop machines with a hard-drive or ssd with at least 30Gb of storage

• Any USB drive with at least 2Gbs of storage

• Internet connection through ethernet cable

• Keyboard

• Monitor and cables

Needed software

• Image burner, recommended:

Preparing USB flash drive

Download and use the Generic x86_64 (GPT) image for regular amd machines at:

Use the image burner to burn the image to the usb flash drive.

Installing the Offline Toolkit

• Insert the flashed USB into the computer

• Insert the ethernet cable with Internet coming from your router into the computer

• Discover how to trigger boot menu or how to enter BIOs and ajusting booting order

• Select boot to happen throgh UEFI or USB, and the device should start setup

• Setup can take several minutes depending on the computer's capabilities

• Check the for the device to come online, or check if a new WiFi hotspos has appeared

• In case a long time has passed without anything happening, unplug and re-plug power supply

In case you have problems with your setup, check the section. If everything worked, check to get content into your new Offline Toolkit.

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:

balena run -d \
    --name=tailscaled \
    --restart always \
    -e TS_STATE_DIR=/var/lib/tailscale \
    -v tailscale-state:/var/lib/tailscale \
    -v /dev/net/tun:/dev/net/tun \
    --network=host \
    --privileged \
    tailscale/tailscale tailscaled

And to start the tailscale service, run:

balena exec tailscaled tailscale up --advertise-routes=10.0.3.0/24 --accept-routes --reset

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

Then enable the subnets 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:

docker run -d \
    --name=tailscaled \
    --restart always \
    -e TS_STATE_DIR=/var/lib/tailscale \
    -v tailscale-state:/var/lib/tailscale \
    -v /dev/net/tun:/dev/net/tun \
    --network=host \
    --privileged \
    tailscale/tailscale tailscaled

And to start tailscale:

docker exec tailscaled tailscale up --advertise-routes=10.0.3.0/24 --accept-routes --reset

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 official repository.

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:

docker run -it \
    -d \
    --restart always \
    -v bv_pid:/app/pid \
    --device=/dev/kvm \
    --cap-add=net_admin \
    -e API_TOKEN="your_balena_token" \
    -e FLEET="your_balena_fleet" \
    -e MEM=1024M \
    -e DISK=20G \
    -e DEV_MODE=true \
    --network host \
    ghcr.io/balena-labs-research/balena-virt:latest

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

⚠️ 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 Troubleshooting section of this guide. For additional help, see the Support section.

Different processes

Any old computer can be recycled to run the Earth Defenders Offline Toolkit software stack. Ideally you should format old machines to run our light Operating System, see Regular computers.

The Offline Toolkit can also run the services alongside your existing Operating System see Using Docker. This process is unsupported and disconnected from Balena Cloud, thus respects data sovereignty.

If the intention to purchase a new device for this purpose, we encourage buying a single-board-computer, as they tend to be cheaper, more mobile, uses less energy and are easier to setup, see Single-board-computers.

Supported Installations

The Digital Democracy team will have access to the device and all data, but will not access or extract data without consent. We'll monitor devices for software and hardware problems, so we can provide support.

But the Balena company will also have backdoors into the device, which most probably won't be used, but can be used.

We currently generate supported ready-to-use images that can be flashed into any regular computer and selected single-board-computers.

To see all released support-mode images head to: http://releases.earthdefenderstoolkit.com

Continue to Choosing a device to find the best fit for your needs.

Unsupported installations

The process is very similar to the supported one, but instead of downloading our image you'll create your own using Balena Cloud. Simply click here and Balena will walk you through the process.

You'll generate your own image, but running our software. That way you can manage your own fleet of devices.

Check Connecting to the internet and Syncing content to learn how to get the content for your Offline Toolkit.

You'll still need to get in touch with us at least to authorize syncing the content, see Support.

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 Github repository, and burning them to an class 10 micr-sdcard using a software such as Balena Etcher.

Recommended: Rock Pi 4 B+

We recommend the Rock Pi 4 B+ 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:

• Rock Pi 4B

• 3.5A USB C power supply

• 32GB Class 10 Micro SD card

• Case with built-in heatsink

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 release page, 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 Intel Nuc.

Recommended: ZimaBoard

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

• ZimaBoard

• PCIe WiFi Adapter

• Mini Display to HDMI Adapter

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

• Rock Pi 4 (~90 USD) 🇺🇸

  • 4GB LPDDR4

  • RK3399 Hexa-Core

  • Gigabit Ethernet

  • Dual-Band WiFi

• Raspberry Pi 4 (~125 USD - ~152 USD) 🇺🇸

  • 1GB / 2GB / 4GB / 8GB LPDDR4

  • BCM2711 Quad-Core

  • Gigabit Ethernet

  • Dual-Band WiFi

• reRouter CM4 1432 (~160 USD) 🇨🇳

  • Includes casing & power supply

  • 4GB LPDDR4

  • 32GB eMMC

  • BCM2711 Quad-Core

  • 2x Gigabit Ethernet

  • Dual-Band WiFi

• RockPro 64 (~80 USD) 🇨🇳

  • 4GB LPDDR4

  • RK3399 Hexa-Core

  • Gigabit Ethernet

  • No WiFi included

• ZimaBoard (~120 USD - ~200 USD) 🇺🇸

  • Includes casing & power supply

  • 16GB / 32GB eMMC

  • 4GB / 8GB LPDDR4

  • Intel Celeron N3350

  • 2x Gigabit Ethernet

  • No Wifi, but 4x PCIe ports for dongle

• ODYSSEY-X86 (~220 USD - ~300 USD) 🇨🇳

  • 0 / 64GB / 128GB eMMC

  • 8GB LPDDR4

  • Intel Celeron J4125

  • 2x Gigabit Ethernet

  • Dual-Band WiFi

  • 2x M.2 PCIe

• Khadas VIM2 (~89 USD - ~100 USD) 🇺🇸

  Not confirmed Balena support

  • 16GB / 32GB eMMC

  • 2GB / 3GB LPDDR4

  • Amlogic S912 1.5 GHz 64Bit Octa Core ARM Cortex-A53 750MHz

  • Gigabit Ethernet

  • Dual-Band WiFi MIMO 🔥

Fanless Mini PCs

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

• Bmax B1 Plus (~120 USD) 🇺🇸

  • 8GB DDR3

  • 128GB SSD

  • Intel Celeron

  • Gigabit Ethernet

  • Dual-Band WiFi

• N40 (~110 USD) 🇺🇸

  • 4GB DDR4

  • 64GB eMMC

  • Intel Celeron

  • Gigabit Ethernet

  • Dual-Band WiFi

• Beelink T4 Pro (~100 USD) 🇺🇸

  • 4GB DDR

  • 64GB eMMC

  • Intel Celeron

  • Gigabit Ethernet

  • Dual-Band WiFi

• MeLE Quieter2Q (180 USD - 280 USD) 🇺🇸

  • 4GB - 8GB LPDDR4

  • 64GB - 512GB M.2 SSD

  • Intel Celeron

  • Gigabit Ethernet

  • Dual-Band WiFi

• AWOW (~130 USD) 🇺🇸

  • 4GB DDR4

  • 64GB eMMC

  • Intel Celeron

  • Gigabit Ethernet

  • Dual-Band WiFi

⚠️ 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: http://edt.local:8079/#/configuration

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:

On that page you can change the Environment Varibles for customization.

For example, the base maps for Terrastories,and the Observations Map can be changed by changing the OFFLINE_MAP_STYLE variable:

The device's default edt.local adress can be changed by changing the hostname:

The device's will now be acessible via http://mygroup.local

When changing hostname other variables need to changed to reflect the new addresss: SET_HOSTNAME, HOST_HOSTNAME, OFFLINE_MAP_STYLE

By setting values to specific variables we can change some behaviors, such as:

• Change WiFi SSID (hotspot name): PWC_HOTSPOT_SSID

• Change WiFi password: PWC_HOTSPOT_PASSWORD

• Change device's address: SET_HOSTNAME

• Change default username for Filebrowser and Syncthing: ADMIN_LOGIN

• Change default password for Filebrowser and Syncthing: ADMIN_PASSWORD

• Change project key for Mapeo: MAPEO_PROJECT_KEY

• Change Mapeo category that Terrastories place's will be collected from: MAPEO_TERRASTORIES_TYPE

• Should be set according to SET_HOSTNAME in order for Terrastories to work properly: HOST_HOSTNAME

• The offline map that Terrastories will use: OFFLINE_MAP_STYLE

Syncing content

Sync source

The source Syncthing instance that the device will sync from

• SYNC_SOURCE_ID

• SYNC_SOURCE_NAME

Crawled websites

• SYNC_CRAWLS_ID

• SYNC_CRAWLS_NAME

Mapeo configurations

• SYNC_MAPEO_ID

• SYNC_MAPEO_NAME

Map tiles

• SYNC_TILES_ID

• SYNC_TILES_NAME

F-Droid repository

• SYNC_FDROID_ID

• SYNC_FDROID_NAME

Application installers

• SYNC_INSTALLERS_ID

• SYNC_INSTALLERS_NAME

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 implantando o EDT Offline usando o Docker, pois atualmente estamos dependendo do Balena Cloud, que oferece à equipe do Balena backdoors para qualquer dispositivo. Temos planos de migrar para o uso do Open Balena, 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 Docker.

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

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

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

• https://github.com/digidem/edt-app-crawler

• https://github.com/digidem/mapeo-bridge

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

• https://github.com/digidem/edt-apps (WIP)

• https://github.com/digidem/edt-fdroid-repository (WIP)