Installing Mapeo Desktop

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

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 http://mapeo.app.

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

If you don't yet have the installation file for Windows, download it.
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.\

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.

Install on macOS

If you don't yet have the installation file for macOS, download it.
Find the Mapeo installation file (.dmg) on your computer and double click on it to open.
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.

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

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.

Install on Linux

Download installation file

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

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

If you previously downloaded 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.

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