Mapeo Support Materials
English
English
  • Introduction
  • Overview
    • About Mapeo
      • Mapeo tools
      • Peer-to-peer & Mapeo sync
      • How Mapeo is being used
    • Is Mapeo right for me?
    • FAQs
  • Quick start guide
    • Getting started
    • Mapeo Mobile
    • Mapeo Desktop
  • Complete Reference guide
    • Welcome – Introduction
    • 🗒️Essentials for a successful Mapeo project
      • Planning a Mapeo project
        • What is the project goal?
        • What outputs do you want?
        • What information to collect?
          • Data types within Mapeo
        • Who should be involved and how?
        • What are the parameters?
      • Security & risk assessment
      • Creating user protocols
    • ✔️Will Mapeo work out-of-the-box for me?
      • Default configuration
      • Default background map
    • ⚙️Customization options
      • Translating Mapeo & default configurations
      • Custom configurations
        • Creating custom configurations
          • Planning configuration & data structure
            • Categories
            • Icons
            • Details fields
          • Coding configuration
            • Adding icon files
              • Creating and exporting SVG files using Adobe Illustrator
              • Creating and exporting SVG files using Inkscape
            • Creating details fields
            • Creating categories
            • Defining geometry defaults
            • Adding a project key
            • Adding project name and version
            • Building configuration file
              • Via the command line
              • Using GitHub Actions
          • Testing and iterating
      • Custom background maps
        • Creating custom background maps
          • Generating map files in .mbtiles format for the experimental Background Maps feature
    • 📱Mapeo Mobile installation & setup
      • Installing Mapeo Mobile
      • Choosing Mapeo Mobile settings
      • Experiments: Turning on experimental features
        • Directional Arrow
        • P2P (peer-to-peer) App Updates
        • Background Maps
        • Security
          • App Passcode
          • Obscure Passcode
      • Importing configurations into Mapeo Mobile
      • Adding custom background maps to Mapeo Mobile
      • Updating Mapeo Mobile
    • 📱Mapeo Mobile use
      • Activating GPS and viewing current location
      • Creating observations
      • Viewing observations
      • Editing and deleting observations
      • Sharing data externally
      • Syncing data via Wi-Fi
    • 💻Mapeo Desktop installation & setup
      • Installing Mapeo Desktop
      • Choosing Mapeo Desktop language
      • Importing configurations to Mapeo Desktop
      • Adding custom background maps to Mapeo Desktop
      • Updating Mapeo Desktop
    • 💻Mapeo Desktop use
      • Mapeo Desktop for managing Mapeo Mobile data (Observations mode)
        • Synchronizing data
          • Synchronizing via Wi-Fi
          • Synchronizing with a file
        • Viewing observations
        • Editing and deleting observations
        • Exporting data & sharing externally
      • Mapeo Desktop for creating territory data (Territory mode)
        • Navigating around the map
        • Creating and editing territory data
        • Changing background maps in Territory mode
        • Importing and using external geospatial data
        • Exporting and syncing data
      • Synchronizing data with Mapeo Desktop
    • 💡Mapeo trainings
      • Defining goals and format
      • Structuring a training
        • Best practices for planning a training
        • Structuring the agenda, content and activities
          • Suggestions for the different sections of a training event
          • Tips and suggested activities for training key features of Mapeo
          • Materials and resources available for the training event
      • Preparing equipment and supplies for a training
        • Recommended equipment and supplies
        • Tech preparation before doing in-person training
    • 🔧Troubleshooting
      • I can't start Mapeo
      • Mapeo closes automatically
      • I have problems with the GPS in Mapeo
        • GPS is not activated in Mapeo
        • My GPS signal is very weak
      • I have problems with the camera in Mapeo
        • I get a black screen when using the camera
      • I want to update Mapeo Mobile permissions
      • I have sync issues
        • I want to connect to Wi-Fi
        • I want to create local Wi-Fi networks
          • With a portable router
          • With a smartphone
        • The device I want to sync with does not show up on my Synchronize screen
        • I get an error when I try to sync with another device
        • I can't sync with the sync file
        • The person I want to sync with has deleted valuable data
      • Sharing files between devices
      • Saving and printing Mapeo reference materials
      • How do I back up Mapeo Desktop data?
    • Glossary & quick reference sheets
      • Glossary of Mapeo related terms
      • Overview of Mapeo Desktop Territory mode screen
  • For developers
    • Mapeo architecture overview
    • Mapeo repositories
    • Localization
  • Support
  • Additional references
  • Digital Democracy website
Powered by GitBook
On this page
  • Download the installation file
  • Install on Windows
  • Install on macOS ​
  • Install on Linux
  • Download installation file
  • Enable executable permissions
  • Install
  • Installing offline
Export as PDF
  1. Complete Reference guide
  2. Mapeo Desktop installation & setup

Installing Mapeo Desktop

PreviousMapeo Desktop installation & setupNextChoosing Mapeo Desktop language

Last updated 3 years ago

Mapeo Desktop is available for Windows, MacOS and Linux and can be downloaded for free from the .

If you are planning to install the application on a computer that does not have an internet connection, make sure to download the installation file prior to going offline. For more details on offline installation, see Installing offline below.

Download the installation file

If you have an internet connection, you can download the Mapeo Desktop installation file for free from .

It is important to select and use the correct installation file for your operating system:

  • Windows:.exe

  • macOS: .dmg or .zip

  • Linux:.AppImage

Go to the website and click on Download. A download of the installation file for your operating system should start automatically. If the download does not start automatically, or if you'd like to download installation files to use on another operating system, you can find download options at the bottom of the page.

Once you have the installation file downloaded, follow the detailed steps in the sections below to install Mapeo Desktop on the appropriate operating system for your computer:

Install on Windows

  1. Find the Mapeo installation file (.exe) on your computer and double click on it to install. If you get a security message from your operating system, click on Execute anyway.\

Install on macOS ​

  1. Find the Mapeo installation file (.dmg) on your computer and double click on it to open.

If you receive a security message that Mapeo cannot be opened, go to System Preferences, then select Security & Privacy.

Install on Linux

Download installation file

Enable executable permissions

In order to install from the .AppImage file, you'll need to ensure that the file has permissions to run as a program. Find where the installation file was saved on your computer and right-click the file. Select Properties from the menu.

Click on the Permissions tab at the top of the Properties window, then click the checkbox to Allow this file to run as a program.

Install

Double click the .AppImage file and Mapeo Desktop should open automatically.

Installing offline

Now that you have pasted the installation file onto another computer, follow these steps to install Mapeo:

If you don't yet have the installation file for Windows, .

Mapeo Desktop will open automatically when the installation process finishes. If not, go to your computer's desktop or Apps and click the Mapeo Desktop icon to open the application.

If you don't yet have the installation file for macOS, .

Drag the Mapeo icon into your Applications folder.

Once the install is complete, find Mapeo in your Applications folder and double click it to open.

On the bottom half of the window, you should see the message "Mapeo was blocked from use because it is not from an identified developer." Click on Open anyway, then on Open in the pop-up confirmation window. Mapeo Desktop will then open automatically.

If you don't have the installation file for Linux, .

If you or have access to an installation file, you can use it install Mapeo Desktop on other computers without an internet connection.

You can copy the installation file to another computer using a USB drive or send it via Bluetooth. This does not require an internet connection. For more on these methods, see Sharing files between devices.

💻
download it
download it
download it
Mapeo website
http://mapeo.app
mapeo.app
Install on Windows
Install on macOS
Install on Linux
previously downloaded
Install on Windows
Install on macOS
Install on Linux