# Introduction Why and what is Earth Defenders Toolkit Offline? The reality of many communities is that Internet connectivity is unreliable, or non existent. For that reason [Earth Defenders Toolkit](https://earthdefenderstoolkit.com/) 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. # Features 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](https://terrastories.io/) instance * A [Mapeo](https://mapeo.app/) 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](/support-team/online-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 # Use cases The Earth Defenders Offline Toolkit is intended to be used by a group that has a common physical meeting space, which is the coverage area of the device's wifi. That coverage area can be small or large depending on the devices wifi radio, but can expand to cover large areas, such as villages, by connecting them to routers and expanded through mesh networks. Offline Toolkit is meant to help groups onboard new users to the tools curated on the Earth Defenders Toolkit platform, as well as provide common helpful assets and helper applications for these tools. It can also assist organizing data in a local offline environment, and provide ways to sync and share data locally or through the Internet. It's also a great tool for partner organizations to organize and synchronize data with the ground communities. Some Offline Toolkit devices (such as single-board-computers) are small, but aren't so fragile, and with appropriate casing, they can easily travel within a backpack together with clothes. The toolkit can be used mobile, during meetings or fieldwork with the right power supply and weather protection. It's also great for indoor spaces such as a house, a remote base or an office, as long as it’s protected from the weather and other possible hazards, such as children playing. The current included tool workflows are participatory mapping with Mapeo, and land-based story telling with Terrastories. These workflows are meant for: * on-boarding new users to the tools through config files, map tiles etc. * providing mobile and desktop installers for the tools * providing bridging services between the tools * providing documentation and use cases for the tools * providing running instances of the tools, such as Mapeo and Terrastories * providing local storage for organization data (documents, photos, videos, folders, etc.) * providing p2p syncing of the stored data, locally or remotely * providing a way for all content to be updated whenever device is connected to the Internet # FAQ **Does my community or organization have full control and ownership over data stored on an EDT Offline device?** That is only true if you're [deploying EDT Offline using Docker](/device-setup/using-docker), as we're currently relying on [Balena Cloud](https://www.balena.io/cloud), which gives the Balena team backdoors to any device. We have plans to shift to using [Open Balena](https://www.balena.io/open), which will remove those backdoors for the Balena organization. **Can I install EDT Offline in any computer?** Yes, there are two ways of installing EDT Offline in a computer, but both require some technical knowledge in either formating a computer or running [Docker](https://www.docker.com/). # Getting started Do you have a device setup with the Earth Defenders Offline Toolkit? > ⚠️ Check out the [online demo](http://demo.earthdefenderstoolkit.com/) to have the browsing experience of the Offline Toolkit > > :signal\_strength: 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 to[Device usage](/device-usage/first-steps). There are several supported devices and ways to setup computers to run the Offline Toolkit. Head to the [Device setup](/device-setup/introduction) 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. # First steps How do I get started with my device?

Example of equipment needed to setup a device using the Zimaboard computer

Make sure you have a device that was previously setup with the Earth Defenders Offline Toolkit. If your device has an external WiFi card, connect the card to the device before turning it on. If there are external antennas, make sure to connect them.

Zimboard computer with WiFi card connected

Connect the device to the power supply and make sure the device is turned on by checking that the lights are on. If there's an external WiFi card, it should also turn on.

Zimaboard seen sideways

After a couple of minutes, verify that the WiFi hotspot appears on the user's devices. Connect to the hotspot and open the captive portal (for desktops, the captive-portal may not show). Finally, with the portal open, copy the provided URL, open your preferred browser, paste the URL and load the page. You're ready to start exploring. If some content isn't showing up, it might be that you're device hasn't synchronized content yet. To synchronize content with the Earth Defenders Toolkit Cloud, you must first connect your device to the Internet and then contact us for authorization. For detailed instructions check the manual: {% file src="/files/hhAFxQsO65OoEHPKuW3q" %} Continue with guides on: * [Connecting to the internet](/device-usage/first-steps/connecting-to-the-internet) * [Syncing content](/device-usage/first-steps/syncing-content) * [Exploring content](/device-usage/first-steps/exploring-content) # Connecting to the internet The recomended and easiest way to connect any Offline Toolkit device to the Internet is through ethernet cable, directly from the router to the device.

Just don't plug into the router's WAN port, which is usually blue.

Your device can connect to a local WiFi hotspot in order to gain access to the internet, but this feature hasn't been well tested as of yet. To test it out go to the admin panel, and to the **Networking** tab, usually located at:
The device will scan for nearby wifi hotspots. You can then select the one to connect to, enter the password and connect. # Syncing content The Earth Defenders Offline Toolkit comes with an instance of [Syncthing](https://syncthing.net/) running, usually on the address: The default username is `admin` and password is `admin123.` The first time a device is connected it’ll send a request to Earth Defenders Toolkit Cloud to start syncing content. Get the ID from the the local Offline Toolkit Syncthing instance:
Get in touch with us on [Support](/support)and send along your Syncthing ID along with other information. Once we authorize syncing from the EDT Cloud the local Offline Toolkit should start displaying syncing information:
Syncing can take a while because it's a few gigabytes of content. Once that's done, all content should be ready for offline use. # Exploring content There are currently 3 toolkits pre-loaded and running: * Mapping and Monitoring * Land-based storytelling * Local Community Cloud Each toolkit has links or downloads for the applications, as well as documentation and community stories around the tool usage. # Bundled applications These are the bundled applications that come with the Offline Toolkit. #### [Mapeo Data Hub](/device-usage/bundled-applications/mapeo-data-hub) Is a custom made application for the Offline Toolkit that intends to enable bridging content from Mapeo to Terrastories, as well as providing a better experience for Mapeo users. #### [Pataka](/device-usage/bundled-applications/pataka) An instance of Ahau's [Pataka](https://gitlab.com/ahau/pataka) application. #### [Terrastories](/device-usage/bundled-applications/terrastories) An instance of [Terrastories](https://terrastories.app/) application. #### [File management](/device-usage/bundled-applications/file-management) An instance of [FileBrowser](https://filebrowser.org/) application. #### [Content syncronization](/device-usage/bundled-applications/content-syncronization) An instance of [Syncthing](https://syncthing.net/) application that's pre-configured to send a sync requests for content folders to the official EDT Cloud. It can be customized to sync other folders by default, or used to sync any folder on the device. There are also mobile and desktop applications to sync with any device easily. #### [Application installers](/device-usage/bundled-applications/application-installers) A simple custom made application that displays the installers for curated applications. #### [Tile server](/device-usage/bundled-applications/tile-server) An instance of [Tileserver](https://github.com/maptiler/tileserver-gl). #### # Mapeo Data Hub A custom application that can be used for: * Synchronizing Mapeo data from local devices, see [Syncing with Hub](/device-usage/bundled-applications/mapeo-data-hub/syncing-with-hub) * Displaying all observation data on a local offline map, see [Observations map](/device-usage/bundled-applications/mapeo-data-hub/observations-map) * Generating a compatible `csv` file that can be import into Terrastories as a Story Place, see [Mapeo Observations as Terrastories Places](/device-usage/bundled-applications/mapeo-data-hub/mapeo-observations-as-terrastories-places) Any issues can be reported on [Github](https://github.com/digidem/mapeo-bridge). # Syncing with Hub First connect to the Offline Toolkit's WiFi hotspot, or to a wifi network that it's also connected too. Open Mapeo and enter the sync page. Check [documentation on Mapeo sync](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/wifi-sync). You should see the Offline Toolkit device showing up and ready to sync. If not you might need to change your project key. In case you don't have an existing project, download and use the custom Mapeo configuration that's provided, which comes preset with the same project key as the Hub. If you already have a custom project key check [Customization](/device-usage/bundled-applications/mapeo-data-hub/customization) to learn how to set the correct key for the Mapeo Data Hub to work for your team. Read more about project keys [here](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-a-project-key). # Observations map The interface for the Mapeo Data Hub is a map displaying the observations that has been synced. Because this can be dangerous we display only the markers, and no information more. Feedback is welcome on how to safely build this in a way that's useful. # Mapeo Observations as Terrastories Places On the configuration file included with the Offline Toolkit there's a Terrastories category. Every observation marked with it will be processed by the Mapeo Data Hub and placed on a csv file formatted for Terrastories. Once imported into Terrastories, the obversations will be available as Places, and ready to be used to link to Stories and Speakers. # Customization You're project might have a secret key already setup, and so your Mapeo device isn't able to find the Mapeo Hub locally. Check [Customizing experience](/device-usage/customizing-experience)for instructions on how to change variables. You can change project key for Mapeo: `MAPEO_PROJECT_KEY` Add your projects key which can be obtained from the Mapeo sync screen. Change Mapeo category that Terrastories place's will be collected from: `MAPEO_TERRASTORIES_TYPE` Every observation of that category will be included in the csv with Story Places for Terrastories to import. # Pataka The Earth Defenders Offline Toolkit comes with an instance of Āhau's Pataka running, usually on the address: Pataka is an application designed to be run as an always online peer. Ideally this peer is set up with a static, public IP address, (or port forwarding from one). This peer is not able to decrypt any messages (or file) that are private to groups, but will replicate these messages (and files) to ensure they are accessible even when the creator is offline, or so there is a backup. Refer to official website for now: # Terrastories The Earth Defenders Offline Toolkit comes with an instance of Terrastories running, usually on the address: Refer to the official documentation for more information: [https://docs.terrastories.app](https://docs.terrastories.app/overview/getting-started) # File management With the bundled Filebrowser application, community members can create their own accounts, upload and download files from a shared digital space. An administrator can manage users, and different settings and have private content. The default username is `admin` and password is `admin123.` Check guides on: * [Storing locally](/device-usage/bundled-applications/file-management/storing-locally) * [Sharing locally](/device-usage/bundled-applications/file-management/sharing-locally) For syncing content across diferent online or offline devices check the documentation on [Content syncronization](/device-usage/bundled-applications/content-syncronization). # Storing locally The Offline Toolkit provides a storage space for community data. Besides the administrator, all other content is public. The first step is creating a new account for yourself. You'll need to memorize your name and password.
Once logged in you'll have acces to the public space for storing files. Create a personal or team folder and store your files inside.
Be mindful of storage space as there are limits to how much the device can hold. Check [Managing device](/device-usage/managing-device) to learn how to check storage space. # Sharing locally Everyone loggede to the community cloud has access to all folders. But in case you want to share a file with someone who isn't part of the community through the local network, you can use the **Share** functionality of the file browsing application. Select the duration of the share, and if a password is needed, and finally click Share:
Copy the address and share it through other means such as a chat app.
# Content syncronization Somtimes we want to keep data syncronized between devices, such as for having shared documents across different devices, and across for everyone in a team. For that we use the same application used for [Syncing content](/device-usage/first-steps/syncing-content), Syncthing: It's usually running on the address: We can start by adding a folder from our community cloud:
Add a descriptive label to the new folder. The content directory is named `/config` here, so find your folder under it.
Before clicking save, go to the **Advanced** tab. Change the **Folder Type** according to your needs. For the cloud, **Send Only** is worth selecting, as most times we want a single source of truth for the content Finally we can click save. # Application installers A simple interface is provided for downloading installers for different applications. It's locally addressed: Installers for all major systems are provided: Android, iOS, Windows, Mac and Linux. If the installer isn't available for your system, it's because it doesn't exist. # Tile server The Earth Defenders Offline Toolkit comes with an instance of Āhau's Pataka running, usually on the address: Settings can be changed using the FileBrowser application, under the `mbtiles` directory. Locally it's be addressed: . The software [QGIS](https://qgis.org/) can be used to download map tiles, [Mapeo has great documentation](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-base-maps/creating-custom-maps/creating-mbtiles) on how to achieve that. Refer to official website for now: [http://tileserver.org](http://tileserver.org/) # Managing device The Offline Toolkit comes with an administrator interface that's usually located at: [http://edt.local:8079/](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 # Customizing experience > ⚠️ 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:
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 # Introduction What are the basic technical skills needed for this setup? > ⚠️ 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](/device-setup/troubleshooting) section of this guide. For additional help, see the [Support](/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](/device-setup/regular-computers). The Offline Toolkit can also run the services alongside your existing Operating System see [Using Docker](/device-setup/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](/device-setup/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](http://releases.earthdefenderstoolkit.com/) Continue to [Choosing a device](/device-setup/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](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/digidem/edt-offline) 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](/device-usage/first-steps/connecting-to-the-internet) and [Syncing content](/device-usage/first-steps/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](/support). # Choosing a device 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 ![Rock Pi 4 with casing](https://cdn.shopify.com/s/files/1/0248/6557/0909/products/DSC01592_900x600.jpg?v=1636979793) 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](https://github.com/digidem/edt-offline/releases/latest), and burning them to an class 10 micr-sdcard using a software such as [Balena Etcher](https://www.balena.io/etcher). **Recommended: Rock Pi 4 B+** We recommend the [**Rock Pi 4 B+**](https://rockpi.org/rockpi4) 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](https://www.amazon.com/dp/B0B4MWBKR7?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [3.5A USB C power supply](https://www.amazon.com/dp/B07TYQRXTK?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [32GB Class 10 Micro SD card](https://www.amazon.com/dp/B07XDCZ9J3?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [Case with built-in heatsink](https://www.amazon.com/dp/B0B7P41CTS?psc=1\&ref=ppx_yo2ov_dt_b_product_details) #### Cheap, powerful CPU and WiFi, but harder to setup ![Zimaboard with PCI express Wifi module](/files/gyc0pZABb57bue7ziCDv) 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](https://github.com/digidem/edt-offline/releases/latest), 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](https://www.intel.com.br/content/www/br/pt/products/details/nuc.html). **Recommended:** [**ZimaBoard**](https://www.zimaboard.com/) 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](https://www.amazon.com/dp/B0BKL4SRJT?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [PCIe WiFi Adapter](https://www.amazon.com/dp/B08J8BHBXJ?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [Mini Display to HDMI Adapter](https://www.amazon.com/dp/B0134V3KIA?psc=1\&ref=ppx_yo2ov_dt_b_product_details) ### 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](https://a.co/d/95OOIZM) (\~90 USD) 🇺🇸 * 4GB LPDDR4 * RK3399 Hexa-Core * Gigabit Ethernet * Dual-Band WiFi * [Raspberry Pi 4](https://a.co/d/iAgYwIs) (\~125 USD - \~152 USD) 🇺🇸 * 1GB / 2GB / 4GB / 8GB LPDDR4 * BCM2711 Quad-Core * Gigabit Ethernet * Dual-Band WiFi * [reRouter CM4 1432](https://www.seeedstudio.com/Dual-GbE-Carrier-Board-with-4GB-RAM-32GB-eMMC-RPi-CM4-Case-p-5029.html) (\~160 USD) 🇨🇳 * Includes casing & power supply * 4GB LPDDR4 * 32GB eMMC * BCM2711 Quad-Core * 2x Gigabit Ethernet * Dual-Band WiFi * [RockPro 64](https://pine64.com/product/rockpro64-4gb-single-board-computer/) (\~80 USD) 🇨🇳 * 4GB LPDDR4 * RK3399 Hexa-Core * Gigabit Ethernet * No WiFi included * [ZimaBoard](https://www.seeedstudio.com/ZimaBoard-216-X86-p-5298.html) (\~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](https://www.seeedstudio.com/ODYSSEY-X86J4125800-p-4915.html) (\~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](https://a.co/d/0d0TWcv) (\~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](https://www.amazon.com/Bmax-B1-Plus-Computer-Ethernet/dp/B0BHP34TH1/ref=sr_1_4?keywords=Bmax%2BMini%2BPC\&qid=1677967510\&s=electronics\&sr=1-4\&ufe=app_do%3Aamzn1.fos.f5122f16-c3e8-4386-bf32-63e904010ad0\&th=1) (\~120 USD) 🇺🇸 * 8GB DDR3 * 128GB SSD * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [N40](https://a.co/d/5QoK6Uw) (\~110 USD) 🇺🇸 * 4GB DDR4 * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [Beelink T4 Pro](https://a.co/d/9OSdXs4) (\~100 USD) 🇺🇸 * 4GB DDR * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [MeLE Quieter2Q](https://a.co/d/8EMGSYe) (180 USD - 280 USD) 🇺🇸 * 4GB - 8GB LPDDR4 * 64GB - 512GB M.2 SSD * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [AWOW](https://a.co/d/f6pVMX6) (\~130 USD) 🇺🇸 * 4GB DDR4 * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi # Single-board-computers The process for a single-board-computer (SBC) is much simpler, and only requires burning an sd card. **Recomended devices:** * [Raspberry Pi 4](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) * [RockPi 4 B+](https://wiki.radxa.com/Rock4/4abplus) #### Needed hardware * Any of [supported devices](http://releases.earthdefenderstoolkit.com/) * 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: [Balena Etcher](https://www.balena.io/etcher/) #### Preparing USB flash drive Download the appropriate image for your device: [http://releases.earthdefenderstoolkit.com](http://releases.earthdefenderstoolkit.com/) 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 [Balena Dashboard](https://dashboard.balena-cloud.com/) for the device to come online, or check if a new WiFi hotspot has appeared # Regular computers 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:** * [Zimaboard 432](https://shop.zimaboard.com/products/zimaboard-single-board-server-for-creators-8g-32gb-linux-windows-openwrt-pfsense-andorid-libreelec-development-board-low-cost-hackable-single-board-server) #### 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: [Balena Etcher](https://www.balena.io/etcher/) #### Preparing USB flash drive Download and use the **Generic x86\_64 (GPT)** image for regular amd machines at: [http://releases.earthdefenderstoolkit.com](http://releases.earthdefenderstoolkit.com/) 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 [Balena Dashboard](https://dashboard.balena-cloud.com/) 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 [Troubleshooting](/device-setup/troubleshooting) section. If everything worked, check [Syncing content](/device-usage/first-steps/syncing-content) to get content into your new Offline Toolkit. # Using Balena Cloud > 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](https://www.balena.io/etcher/). Anyone can deploy there own EDT-Offline by following these steps: 1. Click on "[Deploy with Balena](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/digidem/edt-offline)” 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](https://dashboard.balena-cloud.com), 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](https://hub.balena.io). # Using Docker You'll need any computer with an Operaying System that can run [Docker](https://www.docker.com/) & [docker-compose](https://docs.docker.com/get-started/08_using_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](https://www.docker.com/) * [docker-compose](https://docs.docker.com/get-started/08_using_compose/) * [git](https://git-scm.com/downloads) 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 # Troubleshooting Get in touch with us for [Support](/support). # Onboarding new device # Devices dashboard * What's Balena # Online Cloud The Earth Defenders Toolkit Cloud is a code-as-infraestructure meant to be used by Digital Democracy's project team as well as replicated by other organizations giving support to communities. The purpose of these servers is to bootstrap and update content for instances of the Earth Defenders Toolkit Offline, and as they have high availability. # Services ## Syncthing A free, open-source peer-to-peer file synchronization application available for most plaforms. It can sync files between devices on a local network, or between remote devices over the Internet. Data security and data safety are built into the design of the software. It’s a FOSS alternative to [Resilio Sync](https://www.resilio.com). The app is used for keeping up-to-date content (mapeo configs and tiles, offline websites, f-droid repository, etc) available for when community or organization devices go online. The initial handshake between instance in the cloud and other devices is initialized automatically by the EDT Offline device, but needs to be accepted by someone with access to the Cloud service. ## File Browser Provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit files. It allows the creation of multiple users and each user can have its own directory. It can be used as a standalone app. It's a FOSS alternative to Google Drive, without the office suites.\*\*\*\* It's used for browsing content both in the cloud as well as on the offline device. The team giving support to communities should use it to add or remove content that's hosted on the cloud. The offline devices can use it to share files back with the support team, or within the local network. ## F-Droid Repository F-Droid is an app store and software repository for Android. Applications can be browsed, downloaded and installed from the client app without the need to register for an account. It's a FOSS alternative to the Google Play store. We’ve forked a client app and created our own [EDT Apps](https://github.com/digidem/edt-apps) client, which comes with our own [EDT app repository](https://github.com/digidem/edt-fdroid-repository), as well as the repository that's running on the EDT Offline devices. Regular F-Droid clients can also make use of the EDT repository by simply adding the url to their list of repositories or scanning the QR code presented. ## Secure Scuttlebut Room The main client app, [Manyverse](https://www.manyver.se/), is a social network without the bad stuff, built on the peer-to-peer SSB protocol. It's free and open source, and available for desktop and mobile. It's not running in the cloud owned by a company, instead, all data lives entirely on user devices. This way, even when offline, users can scroll, read anything, and even write posts and like content. When the device is back online, it syncs the latest updates directly with other devices, through a shared local Wi-Fi or on the internet. The SSB Room is a service that enables peers to “meet” online and exchange data. By running our own Room we can connect partners between themselves as well as support teams. It has user management features (allow- & denylisting + moderator & administrator roles), all administered via the web dashboard. ## Minio Storage MinIO is a high performance object storage solution that provides an Amazon Web Services S3-compatible API and supports all core S3 features. It’s a FOSS alternative to Amazon S3. It's used for organizing Terrastories data into buckets. That way if a partner wants to have it’s Terrastories published on the cloud, we can sync it’s Minio bucket, which is running on the EDT Offline device, and run a Terrastories instance on the cloud pulling from that data. It provides an organized way of maintaining online and offline Terrastories instances in sync. # Customizing synced content ### 1. Web scrapping The scrapping of websites is done by [browsertrix-crawler](https://github.com/webrecorder/browsertrix-crawler) command-line. Find more instructions in the [crawling documentation](https://www.notion.so/Web-Crawling-c8f980b0fac54cdc9c2d9a308461ddd9). Some experimentation is needed to find best practices on how to get exactly the amount of pages we want scraped, and for each language. The scrapping might take a long time. Use the output warcz files on the next step. ### 2. Upload to the Cloud Navigate to the [FileBrowser service](https://files.earthdefenderstoolkit.com) on the EDT cloud.
There are different directories within the `content` directory, each for a content type: F-Droid repository data; Desktop installers; Mapeo data (configs and tiles); and Offline Websites. Create a new folder for your new content if needed: Make sure there’s enough left storage on the server, and to upload new content simply drag to the folder or use the upload icon to select the file from your computer:
Once the new content is uploaded we can sync it to EDT devices. ### 3. Sync it Navigate to the [Syncthing service](http://sync.earthdefenderstoolkit.com/) on the EDT cloud and follow the same steps as in [Content syncronization](/device-usage/bundled-applications/content-syncronization). ### 4. Adding to device Check instructions on [Syncing content](/device-usage/first-steps/syncing-content)on how to start syncing with a new device. You'll how to get your Syncthing ID. On the EDT Cloud instance search for that ID:
Give the new device a descriptive name, and got to the **Sharing** page:
On the **Sharing** page select all the folders that are relevant for the new device, usually the defautls:
On EDT Cloud you should see that the device is starting to sync:
On the local Offline Toolkit you should also see syncing happening with more details such as download rate, and amount synced so far. You're done. Now every time the Cloud updates the content folder, the Offline Toolkit devices will automatically sync whenever they're online. # Managing EDT Cloud # Setting up EDT Cloud # Architecture overview * Balena: OS, Cloud # Repositories * * * * * * * (WIP) * (WIP) # Development workflow * * Github Actions * # Development devices ### 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](https://tailscale.com) for that. SSH into the virtual Balena device using the **UUID** which can be obtained from the Balena dashboard: `balena ssh ` 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](https://tailscale.com/kb/1019/subnets/#step-3-enable-subnet-routes-from-the-admin-console) 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.: ### Setting up a virtual-machine Read details on the [official repository](https://github.com/balena-labs-research/balena-virt). 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. # Translating # Support Get in touch with us Write to us at or go through our [inquiry form](https://forms.gle/uvK5cZQPi4YQCof67) 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](https://discord.gg/ZDPWMyQP), [Telegram](https://t.me/+3t9fPkrkg4oxNjU5) group and [online forum](https://forum.earthdefenderstoolkit.com/). # Introduction Why and what is Earth Defenders Toolkit Offline? The reality of many communities is that Internet connectivity is unreliable, or non existent. For that reason [Earth Defenders Toolkit](https://earthdefenderstoolkit.com/) 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. # Features 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](https://terrastories.io/) instance * A [Mapeo](https://mapeo.app/) 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](/portugues/support-team/online-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 # Use cases 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. # FAQ **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](/portugues/device-setup/using-docker), pois atualmente estamos dependendo do [Balena Cloud](https://www.balena.io/cloud), que oferece à equipe do Balena backdoors para qualquer dispositivo. Temos planos de migrar para o uso do [Open Balena](https://www.balena.io/open), 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://www.docker.com/). # Getting started Do you have a device setup with the Earth Defenders Offline Toolkit? > ⚠️ Check out the [online demo](http://demo.earthdefenderstoolkit.com/) to have the browsing experience of the Offline Toolkit > > :signal\_strength: 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 to[https://github.com/digidem/edt-docs/blob/portuguese/introduction/broken-reference/README.md](https://github.com/digidem/edt-docs/blob/portuguese/introduction/broken-reference/README.md "mention"). 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](https://github.com/digidem/edt-docs/blob/portuguese/introduction/broken-reference/README.md "mention") 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. # First steps Como começar com o meu dispositivo?

Exemplo de equipamentos necessários para configurar um dispositivo usando o computador Zimaboard

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.

Computador Zimboard com cartão WiFi conectado

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.

Zimaboard visto de lado

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: {% file src="/files/9spmHeEQQtyoaX68CgDr" %} Continue com os guias sobre: * [connecting-to-the-internet.md](/portugues/device-usage/first-steps/connecting-to-the-internet) * [syncing-content.md](/portugues/device-usage/first-steps/syncing-content) * [exploring-content.md](/portugues/device-usage/first-steps/exploring-content)". # Connecting to the internet 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. # Syncing content O Earth Defenders Toolkit Offline vem com uma instância do [Syncthing](https://syncthing.net/) 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 [support.md](/portugues/support) 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. # Exploring content 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. # Bundled applications Esses são os aplicativos integrados que vêm com a Offline Toolkit. #### [Mapeo Data Hub](/portugues/device-usage/bundled-applications/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](/portugues/device-usage/bundled-applications/pataka) Uma instância do aplicativo [Pataka](https://gitlab.com/ahau/pataka) de Ahau. #### [Terrastories](/portugues/device-usage/bundled-applications/terrastories) Uma instância do aplicativo [Terrastories](https://terrastories.app/). #### [File management](/portugues/device-usage/bundled-applications/file-management) Uma instância do aplicativo [FileBrowser](https://filebrowser.org/). #### [Content syncronization](/portugues/device-usage/bundled-applications/content-syncronization) Uma instância do aplicativo [Syncthing](https://syncthing.net/) 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](/portugues/device-usage/bundled-applications/application-installers) Um aplicativo simples e personalizado que exibe os instaladores para os aplicativos selecionados. #### [Tile server](/portugues/device-usage/bundled-applications/tile-server) Uma instância de [Tileserver](https://github.com/maptiler/tileserver-gl). #### # Mapeo Data Hub Um aplicativo personalizado que pode ser usado para: * Sincronizar dados do Mapeo de dispositivos locais, veja [sincronizando-com-hub.md](https://github.com/digidem/edt-docs/blob/portuguese/device-usage/bundled-applications/mapeo-data-hub/sincronizando-com-hub.md) * Exibir todos os dados de observação em um mapa offline local, veja [mapas-de-observacao.md](https://github.com/digidem/edt-docs/blob/portuguese/device-usage/bundled-applications/mapeo-data-hub/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](https://github.com/digidem/edt-docs/blob/portuguese/device-usage/bundled-applications/mapeo-data-hub/observacoes-do-mapeo-como-locais-do-terrastories.md) Problemas podem ser reportados no [Github](https://github.com/digidem/mapeo-bridge). # Syncing with Hub 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](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/wifi-sync). 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](/portugues/device-usage/bundled-applications/mapeo-data-hub/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](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-a-project-key). # Observations map 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. # Mapeo Observations as Terrastories Places 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. # Customization > ## 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](https://github.com/digidem/edt-docs/blob/portuguese/device-usage/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. # Pataka 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: # Terrastories 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: [https://docs.terrastories.app/pt-BR](https://docs.terrastories.app/pt-BR/overview/getting-started) # File management 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: * [storing-locally.md](/portugues/device-usage/bundled-applications/file-management/storing-locally) * [sharing-locally.md](/portugues/device-usage/bundled-applications/file-management/sharing-locally) Para sincronizar conteúdo entre diferentes dispositivos online ou offline, verifique a documentação em [content-syncronization.md](/portugues/device-usage/bundled-applications/content-syncronization). # Storing locally 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 [managing-device.md](/portugues/device-usage/managing-device) para saber como verificar o espaço de armazenamento. # Sharing locally 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.
# Content syncronization À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](https://github.com/digidem/edt-docs/blob/portuguese/device-usage/primeiros-passos/sincronizacao-de-conteudo.md), 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** 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. # Application installers Uma interface simples é fornecida para fazer o download de instaladores para diferentes aplicativos. Ela está localmente endereçada em: 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. # Tile server 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 [QGIS](https://qgis.org/) pode ser usado para baixar os tiles do mapa, e o [Mapeo tem uma ótima documentação](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-base-maps/creating-custom-maps/creating-mbtiles) sobre como fazer isso. Consulte o site oficial por enquanto: [http://tileserver.org](http://tileserver.org/) # Managing device The Offline Toolkit comes with an administrator interface that's usually located at: [http://edt.local:8079/](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 # Customizing experience > ⚠️ 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:
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 # Introduction What are the basic technical skills needed for this setup? > ⚠️ 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](/portugues/device-setup/troubleshooting) section of this guide. For additional help, see the [Support](/portugues/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](/portugues/device-setup/other-computers). The Offline Toolkit can also run the services alongside your existing Operating System see [Using Docker](/portugues/device-setup/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](/portugues/device-setup/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](http://releases.earthdefenderstoolkit.com/) Continue to [Choosing a device](/portugues/device-setup/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](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/digidem/edt-offline) 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](/portugues/device-usage/first-steps/connecting-to-the-internet) and [Syncing content](/portugues/device-usage/first-steps/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](/portugues/support). # Choosing a device 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 ![Rock Pi 4 with casing](https://cdn.shopify.com/s/files/1/0248/6557/0909/products/DSC01592_900x600.jpg?v=1636979793) 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](https://github.com/digidem/edt-offline/releases/latest), and burning them to an class 10 micr-sdcard using a software such as [Balena Etcher](https://www.balena.io/etcher). **Recommended: Rock Pi 4 B+** We recommend the [**Rock Pi 4 B+**](https://rockpi.org/rockpi4) 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](https://www.amazon.com/dp/B0B4MWBKR7?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [3.5A USB C power supply](https://www.amazon.com/dp/B07TYQRXTK?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [32GB Class 10 Micro SD card](https://www.amazon.com/dp/B07XDCZ9J3?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [Case with built-in heatsink](https://www.amazon.com/dp/B0B7P41CTS?psc=1\&ref=ppx_yo2ov_dt_b_product_details) #### Cheap, powerful CPU and WiFi, but harder to setup ![Zimaboard with PCI express Wifi module](/files/gyc0pZABb57bue7ziCDv) 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](https://github.com/digidem/edt-offline/releases/latest), 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](https://www.intel.com.br/content/www/br/pt/products/details/nuc.html). **Recommended:** [**ZimaBoard**](https://www.zimaboard.com/) 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](https://www.amazon.com/dp/B0BKL4SRJT?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [PCIe WiFi Adapter](https://www.amazon.com/dp/B08J8BHBXJ?psc=1\&ref=ppx_yo2ov_dt_b_product_details) * [Mini Display to HDMI Adapter](https://www.amazon.com/dp/B0134V3KIA?psc=1\&ref=ppx_yo2ov_dt_b_product_details) ### 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](https://a.co/d/95OOIZM) (\~90 USD) 🇺🇸 * 4GB LPDDR4 * RK3399 Hexa-Core * Gigabit Ethernet * Dual-Band WiFi * [Raspberry Pi 4](https://a.co/d/iAgYwIs) (\~125 USD - \~152 USD) 🇺🇸 * 1GB / 2GB / 4GB / 8GB LPDDR4 * BCM2711 Quad-Core * Gigabit Ethernet * Dual-Band WiFi * [reRouter CM4 1432](https://www.seeedstudio.com/Dual-GbE-Carrier-Board-with-4GB-RAM-32GB-eMMC-RPi-CM4-Case-p-5029.html) (\~160 USD) 🇨🇳 * Includes casing & power supply * 4GB LPDDR4 * 32GB eMMC * BCM2711 Quad-Core * 2x Gigabit Ethernet * Dual-Band WiFi * [RockPro 64](https://pine64.com/product/rockpro64-4gb-single-board-computer/) (\~80 USD) 🇨🇳 * 4GB LPDDR4 * RK3399 Hexa-Core * Gigabit Ethernet * No WiFi included * [ZimaBoard](https://www.seeedstudio.com/ZimaBoard-216-X86-p-5298.html) (\~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](https://www.seeedstudio.com/ODYSSEY-X86J4125800-p-4915.html) (\~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](https://a.co/d/0d0TWcv) (\~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](https://www.amazon.com/Bmax-B1-Plus-Computer-Ethernet/dp/B0BHP34TH1/ref=sr_1_4?keywords=Bmax%2BMini%2BPC\&qid=1677967510\&s=electronics\&sr=1-4\&ufe=app_do%3Aamzn1.fos.f5122f16-c3e8-4386-bf32-63e904010ad0\&th=1) (\~120 USD) 🇺🇸 * 8GB DDR3 * 128GB SSD * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [N40](https://a.co/d/5QoK6Uw) (\~110 USD) 🇺🇸 * 4GB DDR4 * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [Beelink T4 Pro](https://a.co/d/9OSdXs4) (\~100 USD) 🇺🇸 * 4GB DDR * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [MeLE Quieter2Q](https://a.co/d/8EMGSYe) (180 USD - 280 USD) 🇺🇸 * 4GB - 8GB LPDDR4 * 64GB - 512GB M.2 SSD * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi * [AWOW](https://a.co/d/f6pVMX6) (\~130 USD) 🇺🇸 * 4GB DDR4 * 64GB eMMC * Intel Celeron * Gigabit Ethernet * Dual-Band WiFi # Single-board-computers The process for a single-board-computer (SBC) is much simpler, and only requires burning an sd card. **Recomended devices:** * [Raspberry Pi 4](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) * [RockPi 4 B+](https://wiki.radxa.com/Rock4/4abplus) #### Needed hardware * Any of [supported devices](http://releases.earthdefenderstoolkit.com/) * 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: [Balena Etcher](https://www.balena.io/etcher/) #### Preparing USB flash drive Download the appropriate image for your device: [http://releases.earthdefenderstoolkit.com](http://releases.earthdefenderstoolkit.com/) 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 [Balena Dashboard](https://dashboard.balena-cloud.com/) for the device to come online, or check if a new WiFi hotspot has appeared # Regular computers 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:** * [Zimaboard 432](https://shop.zimaboard.com/products/zimaboard-single-board-server-for-creators-8g-32gb-linux-windows-openwrt-pfsense-andorid-libreelec-development-board-low-cost-hackable-single-board-server) #### 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: [Balena Etcher](https://www.balena.io/etcher/) #### Preparing USB flash drive Download and use the **Generic x86\_64 (GPT)** image for regular amd machines at: [http://releases.earthdefenderstoolkit.com](http://releases.earthdefenderstoolkit.com/) 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 [Balena Dashboard](https://dashboard.balena-cloud.com/) 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 [Troubleshooting](/portugues/device-setup/troubleshooting) section. If everything worked, check [Syncing content](/portugues/device-usage/first-steps/syncing-content) to get content into your new Offline Toolkit. # Using Balena Cloud > 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](https://www.balena.io/etcher/). Anyone can deploy there own EDT-Offline by following these steps: 1. Click on "[Deploy with Balena](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/digidem/edt-offline)” 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](https://dashboard.balena-cloud.com), 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](https://hub.balena.io). # Using Docker You'll need any computer with an Operaying System that can run [Docker](https://www.docker.com/) & [docker-compose](https://docs.docker.com/get-started/08_using_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](https://www.docker.com/) * [docker-compose](https://docs.docker.com/get-started/08_using_compose/) * [git](https://git-scm.com/downloads) 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 # Troubleshooting Get in touch with us for [Support](/portugues/support). # Onboarding new device # Devices dashboard * What's Balena # Online 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. # Services ## 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](https://www.resilio.com). 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](https://github.com/digidem/edt-apps), que vem com nosso próprio repositório [EDT app repository](https://github.com/digidem/edt-fdroid-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](https://www.manyver.se/), é 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. # Customizing synced content ### 1. Web scraping A raspagem de sites é feita pelo comando [browsertrix-crawler](https://github.com/webrecorder/browsertrix-crawler) na linha de comando. Encontre mais instruções na [documentação de raspagem](https://www.notion.so/Web-Crawling-c8f980b0fac54cdc9c2d9a308461ddd9). 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](https://files.earthdefenderstoolkit.com) 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](http://sync.earthdefenderstoolkit.com/) na nuvem do EDT e siga os mesmos passos como em [content-syncronization.md](/portugues/device-usage/bundled-applications/content-syncronization). ### 4. Adicionar ao dispositivo Verifique as instruções em [syncing-content.md](/portugues/device-usage/first-steps/syncing-content) 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. # Managing EDT Cloud # Setting up EDT Cloud # Architecture overview * Balena: OS, Cloud # Repositories * * * * * * * (WIP) * (WIP) # Development workflow * * Github Actions * # Development devices ### 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](https://tailscale.com) for that. SSH into the virtual Balena device using the **UUID** which can be obtained from the Balena dashboard: `balena ssh ` 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](https://tailscale.com/kb/1019/subnets/#step-3-enable-subnet-routes-from-the-admin-console) 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.: ### Setting up a virtual-machine Read details on the [official repository](https://github.com/balena-labs-research/balena-virt). 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. # Translating # Support Get in touch with us Write to us at or go through our [inquiry form](https://forms.gle/uvK5cZQPi4YQCof67) 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](https://discord.gg/ZDPWMyQP), [Telegram](https://t.me/+3t9fPkrkg4oxNjU5) group and [online forum](https://forum.earthdefenderstoolkit.com/). # Introducción La realidad de muchas comunidades es que la conectividad a Internet es poco fiable o no existe. Por esa razón, se puede implementar el [Kit de Herramientas para Defensa de la Tierra](https://earthdefenderstoolkit.com) en computadoras de la comunidad para que todo el contenido pueda estar sin conexión, en una red local, y se puede sincronizar cuando el dispositivo se conecta a Internet. Una computadora que ejecuta el Kit Offline crea un punto de acceso donde las personas con dispositivos dentro del alcance del wifi pueden descargar, instalar y usar aplicaciones creadas en la plataforma del Kit de Herramientas para Defensa de la Tierra. Hemos organizado el contenido en torno a temas como el **mapeo comunitario** y la **narración basada en la tierra**. Para cada uno de estos temas, ofrecemos guías, casos de uso, recursos y aplicaciones auxiliares, que están disponibles a través de una interfaz simple. En la red local, los miembros de la comunidad tienen acceso a aplicaciones para almacenar y compartir su contenido. La herramienta destacada **Terrastories** también se puede usar localmente. # Características Incluso en entornos sin conexión a Internet, los dispositivos (móviles o de escritorio) dentro del alcance del WiFi creado por la computadora de la Offline Toolkit tendrán acceso a: * Todo el contenido en la plataforma EDT: guías sobre protocolos comunitarios y herramientas seleccionadas, así como historias de comunidades de todo el mundo sobre su experiencia en el uso de las herramientas. * Los instaladores para las herramientas seleccionadas. * Una instancia de [Terrastories](https://terrastories.io/). * Una instancia de [Mapeo](https://mapeo.app/) para sincronizar. * Un mapa interactivo que muestra las observaciones de Mapeo que se han sincronizado con el dispositivo. * Una aplicación de navegación de archivos para almacenar y compartir archivos, similar a Google Drive. * La sincronización de contenido, desde [EDT Cloud](https://github.com/digidem/edt-docs/blob/spanish/support-team/online-cloud/README.md) al ordenador local o de un ordenador local a cualquier otro dispositivo, incluidos dispositivos móviles, localmente o a través de Internet. * La sincronización automática del contenido predeterminado (sitios web raspados, instaladores de aplicaciones, configuraciones de Mapeo, mosaicos de mapas). * La creación automática de archivos que se pueden importar en Terrastories, a partir de las observaciones sincronizadas de Mapeo. # Casos de uso El Kit sin conexión de Earth Defenders está destinado a ser utilizado por un grupo que tenga un espacio físico común de reunión, que es el área de cobertura del wifi del dispositivo. Esa área de cobertura puede ser pequeña o grande dependiendo de la radio wifi de los dispositivos, pero puede expandirse para cubrir grandes áreas, como aldeas, conectándolas a enrutadores y expandiéndolas a través de redes de malla. El Kit sin conexión está destinado a ayudar a los grupos a incorporar nuevos usuarios a las herramientas seleccionadas en la plataforma de Earth Defenders Toolkit, así como a proporcionar activos útiles comunes y aplicaciones de ayuda para estas herramientas. También puede ayudar a organizar datos en un entorno local sin conexión, y proporcionar formas de sincronizar y compartir datos localmente o a través de Internet. También es una excelente herramienta para que las organizaciones asociadas organicen y sincronicen datos con las comunidades terrestres. Algunos dispositivos del Kit sin conexión (como las computadoras de placa única) son pequeños, pero no son tan frágiles, y con la carcasa adecuada, pueden viajar fácilmente en una mochila junto con la ropa. El kit se puede utilizar de forma móvil, durante las reuniones o el trabajo de campo con la fuente de alimentación y la protección contra el clima adecuadas. También es ideal para espacios interiores como una casa, una base remota o una oficina, siempre y cuando esté protegido del clima y de otros posibles peligros, como los niños jugando. Los flujos de trabajo de las herramientas incluidas actualmente son la cartografía participativa con Mapeo y la narración de historias sobre la tierra con Terrastories. Estos flujos de trabajo están diseñados para: * incorporar nuevos usuarios a las herramientas a través de archivos de configuración, mosaicos de mapas, etc. * proporcionar instaladores móviles y de escritorio para las herramientas * proporcionar servicios de enlace entre las herramientas * proporcionar documentación y casos de uso para las herramientas * proporcionar instancias en ejecución de las herramientas, como Mapeo y Terrastories * proporcionar almacenamiento local para datos organizativos (documentos, fotos, videos, carpetas, etcétera) * proporcionar sincronización P2P de datos almacenados, local o remotamente * proporcionar una forma de actualizar todo el contenido cada vez que el dispositivo esté conectado a Internet". # Preguntas frecuentes **¿Mi comunidad u organización tiene control completo y propiedad sobre los datos almacenados en un dispositivo EDT Offline?** Esto solo es cierto si estás [implementando EDT Offline usando Docker](https://github.com/digidem/edt-docs/blob/spanish/device-setup/using-docker.md), ya que actualmente dependemos de [Balena Cloud](https://www.balena.io/cloud), lo que le da al equipo de Balena una puerta trasera a cualquier dispositivo. Tenemos planes de cambiar a [Open Balena](https://www.balena.io/open), lo cual eliminará esas puertas traseras para la organización de Balena. **¿Puedo instalar EDT Offline en cualquier computadora?** Sí, hay dos formas de instalar EDT Offline en una computadora, pero ambas requieren algún conocimiento técnico en el formateo de una computadora o en la ejecución de [Docker](https://www.docker.com/). # Empezando > ⚠️ Echa un vistazo a la [demo en línea](http://demo.earthdefenderstoolkit.com/) para tener la experiencia de navegación de la Offline Toolkit > > :signal\_strength: Verás lo que las personas dentro del rango WiFi del dispositivo verán Para empezar a usar Earth Defenders Offline Toolkit, necesitarás configurar una computadora para ejecutar el software. Si ya tienes una, dirígete a [enlace roto](https://github.com/digidem/edt-docs/blob/spanish/introduction/broken-reference/README.md). Existen varios dispositivos compatibles y formas de configurar computadoras para que ejecuten la Offline Toolkit. Dirígete a la sección de [enlace roto](https://github.com/digidem/edt-docs/blob/spanish/introduction/broken-reference/README.md) para entender cómo funciona esto. Si tu equipo carece de las habilidades técnicas necesarias para configurar tu propio dispositivo, por favor contáctanos en Digital Democracy para que podamos ayudarte a elegir el mejor camino para implementar un dispositivo para tu comunidad u organización. # Primeros pasos Asegúrese de tener un dispositivo que haya sido configurado previamente con la Earth Defenders Offline Toolkit. (imagen aquí) Si su dispositivo tiene una tarjeta WiFi externa, conéctela al dispositivo antes de encenderlo. Si hay antenas externas, asegúrese de conectarlas. Conecte el dispositivo a la fuente de alimentación y asegúrese de que esté encendido verificando que las luces estén encendidas. Si hay una tarjeta WiFi externa, también debería encenderse. Después de un par de minutos, verifique que el hotspot WiFi aparece en los dispositivos del usuario. Conéctese al hotspot y abra el portal cautivo (para el escritorio, el portal cautivo puede no aparecer). Finalmente, con el portal abierto, copie la URL proporcionada, abra su navegador preferido, pegue la URL y cargue la página. Está listo para empezar a explorar. Si algunos contenidos no aparecen, puede ser que su dispositivo aún no haya sincronizado el contenido. Para esto, deberá conectar el dispositivo a Internet, ponerse en contacto con nosotros y permitir que su dispositivo sincronice el contenido con la nube de Earth Defenders Toolkit. Consulte las guías en: * [conexión-a-internet.md](https://github.com/digidem/edt-docs/blob/spanish/device-usage/first-steps/conexión-a-internet.md) * [sincronización-de-contenido.md](https://github.com/digidem/edt-docs/blob/spanish/device-usage/first-steps/sincronización-de-contenido.md) * [exploración-de-contenido.md](https://github.com/digidem/edt-docs/blob/spanish/device-usage/first-steps/exploración-de-contenido.md)". # Conexión a internet La forma recomendada y más fácil de conectar cualquier dispositivo Offline Toolkit a Internet es mediante un cable Ethernet, directamente desde el enrutador al dispositivo.

Solo no conecte en el puerto WAN del enrutador, que generalmente es azul.

Su dispositivo puede conectarse a un hotspot WiFi local para acceder a Internet, pero esta función aún no ha sido bien probada. Para probarlo, vaya al panel de administración y vaya a la pestaña **Networking**, por lo general, localizada en:
El dispositivo buscará hotspots WiFi cercanos. Luego puede seleccionar el que desea conectar, ingresar la contraseña y conectarse. # Sincronización de contenido El Kit sin Conexión de Defensores de la Tierra viene con una instancia de [Syncthing](https://syncthing.net/) funcionando, por lo general en la dirección: El nombre de usuario predeterminado es `admin` y la contraseña es `admin123`. La primera vez que se conecta un dispositivo, enviará una solicitud a la Nube del Kit sin Conexión de Defensores de la Tierra para comenzar a sincronizar contenido. Obtenga el ID de la instancia local de Syncthing sin conexión del kit:
Ponte en contacto con nosotros en [https://github.com/digidem/edt-docs/blob/spanish/support.md](https://github.com/digidem/edt-docs/blob/spanish/support.md "mention") y envía tu ID de Syncthing junto con otra información. Una vez que autorizamos la sincronización desde la Nube del EDT, el Kit sin Conexión local debería comenzar a mostrar la información de sincronización:
La sincronización puede tardar un poco porque son varios gigabytes de contenido. Una vez que se complete, todo el contenido debería estar listo para su uso sin conexión. # Explorando contenido Actualmente hay 3 herramientas cargadas y en funcionamiento: * Mapeo y monitoreo * Narración basada en la tierra * Nube de comunidad local Cada herramienta tiene enlaces o descargas para las aplicaciones, así como documentación e historias de la comunidad sobre el uso de la herramienta. # Aplicaciones incluidas #### [mapeo-data-hub](/espanol-1/uso-del-dispositivo/bundled-applications/mapeo-data-hub) Es una aplicación hecha a medida para la herramienta Offline Toolkit que pretende permitir la conexión de contenido desde Mapeo a Terrastories, así como proporcionar una mejor experiencia para los usuarios de Mapeo. #### [pataka.md](/espanol-1/uso-del-dispositivo/bundled-applications/pataka) Una instancia de la aplicación [Pataka](https://gitlab.com/ahau/pataka) de Ahau. #### [terrastories.md](/espanol-1/uso-del-dispositivo/bundled-applications/terrastories) Una instancia de la aplicación [Terrastories](https://terrastories.app/). #### [file-management](/espanol-1/uso-del-dispositivo/bundled-applications/file-management) Una instancia de la aplicación [FileBrowser](https://filebrowser.org/). #### [content-syncronization.md](/espanol-1/uso-del-dispositivo/bundled-applications/content-syncronization) Una instancia de la aplicación [Syncthing](https://syncthing.net/) que está preconfigurada para enviar solicitudes de sincronización para carpetas de contenido a la nube oficial de EDT. Se puede personalizar para sincronizar otras carpetas por defecto, o usarse para sincronizar cualquier carpeta en el dispositivo. También hay aplicaciones móviles y de escritorio para sincronizar con cualquier dispositivo fácilmente. #### [application-installers.md](/espanol-1/uso-del-dispositivo/bundled-applications/application-installers) Una aplicación sencilla hecha a medida que muestra los instaladores para aplicaciones seleccionadas. #### [tile-server.md](/espanol-1/uso-del-dispositivo/bundled-applications/tile-server) Una instancia de [Tileserver](https://github.com/maptiler/tileserver-gl). --- [Next Page](/llms-full.txt/1)