butter-www-2026/www/docs/content-packs/maps.mdx
2026-04-21 14:03:40 -04:00

33 lines
1.4 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
sidebar_position: 2
---
# Maps
You can make offline maps available from your Butter Box. These maps are powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
:::warning
**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.
:::
### ✅ Steps to Enable Maps
**1. Download the map files you need**
* Visit: [OsmAnd Local Indexes List](https://osmand.net/list?sortby=size\&asc=false)
* Choose and download the regions you want available offline.
**2. Organize your files**
* On your USB drive, create a folder named `osm-map-files` .
* Put the **OsmAnd APK** and all your **map files** into this folder.
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
**3. Add to your Butter Box**
* Insert the USB drive into your Butter Box.
* The **Offline Maps** tile will automatically appear in your Butter Box portal.
👉 Thats it — anyone using an **Android device** can now download OsmAnd and the offline maps youve provided directly from your Butter Box.
Note: The OSM map apk is available on the Butter Box software image. Updates to the OsmAnd app will be available with new releases of the Butter Box software. If you want to know what the latest available version of OsmAnd app is, visit [OsmAnd Free Releases — Android](https://osmand.net/docs/versions/free-versions).