# Installing Mapeo Desktop Mapeo Desktop is available for Windows, MacOS and Linux and can be downloaded for free from the [Mapeo website](https://www.digital-democracy.org/mapeo/). {% hint style="info" %} 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](#installing-offline "mention") below. {% endhint %} ## Download the installation file If you have an internet connection, you can download the Mapeo Desktop installation file for free from . {% hint style="info" %} It is important to select and use the correct installation file for your operating system: * Windows:`.exe` * macOS: `.dmg` or `.zip` * Linux:`.AppImage` {% endhint %} Go to the [mapeo.app](https://www.digital-democracy.org/mapeo/) 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. ![](https://lh3.googleusercontent.com/E_z0p4l7yCsYHL4JCBHYKPTwexwyuZmUeCocPedWk4kAiP-fA5dHCBpNmQA6oMBuUd34X3-w8MbF_Za6rUehwNBb3z-Stkr6FnXExz2YPkSW61MNpeME7Nt6xZdlPA) 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**](#install-on-windows) * [**Install on macOS**](#installation-on-macos) * [**Install on Linux**](#install-on-linux) ## Install on Windows 1. If you don't yet have the installation file for Windows, [download it](#download-the-installation-file). 2. 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**.\\ ![](https://lh3.googleusercontent.com/Tsq5jLMWd1wSHKbDzVT_WFc-bUSBtbn3gj-6ta8YqJzQzXqoHDQ5Jw6ehXNz_1ZopSYMZMN0O5ZZ6L4gM5Vuva08ZwHe1mzo0zPZCyK5r10qXb26CtMb1Twbf-l2CA) 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 ​ 1. If you don't yet have the installation file for macOS, [download it](#download-the-installation-file). 2. Find the Mapeo installation file (`.dmg`) on your computer and double click on it to open. 3. Drag the Mapeo icon into your **Applications** folder.\ \ ![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FSfwjdKlcGBcMqK8vwN2r%2FScreen%20Shot%202021-12-21%20at%202.02.59%20PM.png?alt=media\&token=c30bc865-68d0-43a6-add7-83ff289b39fd) 4. Once the install is complete, find **Mapeo** in your **Applications** folder and double click it to open. {% hint style="warning" %} If you receive a security message that Mapeo cannot be opened, go to **System Preferences**, then select **Security & Privacy.**
![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2Fnc2rGs5kshEUMo8YHxdq%2FMac_system_settings_security.png?alt=media\&token=dc6a362f-bb5f-4f4f-b2de-1239519fecd5)\ \ 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.\ \ ![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FYeMFzv0gj2BGyb2stK6A%2FMac_security_open_anyway.png?alt=media\&token=1101ae34-ef27-4932-a3d0-b2fee26b1097) {% endhint %} ## Install on Linux ### Download installation file If you don't have the installation file for Linux, [download it](#download-the-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. ![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FpR99VCw8U8jC2GZkGqXz%2FLinux_right_click_appImage.jpg?alt=media\&token=57c78c46-1e26-4074-b94d-50c7678a6746) 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**. ![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FweVpSvttjlKB59Rxirzi%2FLinux_allow_executable_permissions.jpg?alt=media\&token=c88deb4a-cf0d-4505-b46e-6ac83692d436) ### Install Double click the `.AppImage` file and Mapeo Desktop should open automatically. ## Installing offline If you [previously downloaded](#download-the-installation-file) or have access to an installation file, you can use it install Mapeo Desktop on other computers without an internet connection. {% hint style="info" %} 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](https://docs.mapeo.app/complete-reference-guide/troubleshooting/sharing-files-between-devices "mention"). {% endhint %} Now that you have pasted the installation file onto another computer, follow these steps to install Mapeo: * [**Install on Windows**](#install-on-windows) * [**Install on macOS**](#installation-on-macos) * [**Install on Linux**](#install-on-linux)