Mapbox Atlas

Current version: v2.5.2

  • On-premises vector tile maps
  • Offline Mapbox Studio
  • Full suite of Mapbox APIs behind your firewall

Mapbox Atlas allows you to run Mapbox global maps on your own infrastructure, including behind a firewall or completely offline. Atlas includes an offline instance of the Mapbox Studio style editor, vector tiles, and has built-in support for custom tilesets. This means that you can run the Mapbox Maps APIs and Studio on a specific server or virtual private cloud that you have complete control over, then deploy to your web, mobile, or AR app.

Mapbox Atlas supports the latest Mapbox vector map technology, including Mapbox GL JS, so maps render quickly and are highly customizable.

Atlas license

To install and use Atlas, you must have a Mapbox user account with a valid Atlas license. Atlas ships with a single-user account that can be shared concurrently among many users.

Need an Atlas license? Contact us to learn more.

Atlas installer

The Atlas installer is a command line interface (CLI) utility used to download and set up Atlas on a host server. The installer has many commands that can support different network topologies. The installer is available for both macOS and Linux.

System requirements

You can run the Mapbox Atlas server on the following operating systems:

  • macOS*
  • CentOS 7
  • Ubuntu 14.04
  • Ubuntu 16.04
  • Red Hat Enterprise Linux 7

* Recommended for development only

Tileset size

Below are approximate sizes for each tileset. Exact tileset file sizes are subject to change with new data from weekly updates.

TilesetDevProduction
mapbox.mapbox-terrain-v2450 MB40 GB
mapbox.mapbox-streets-v7300 MB100 GB
mapbox.satellite-full850 MB260 GB
mapbox.satellite-watermark140 MB7 GB
Total1.75 GB407 GB

Enterprise Boundaries Tileset size

Below are approximate sizes for each Enterprise Boundaries tileset. Exact tileset file sizes are subject to change with new data from yearly updates.

TilesetProduction
mapbox.enterprise-boundaries-a0-v21.45 GB
mapbox.enterprise-boundaries-a1-v2 960.9 MB
mapbox.enterprise-boundaries-a2-v2903.1 MB
mapbox.enterprise-boundaries-a3-v2293.4 MB
mapbox.enterprise-boundaries-a4-v282 MB
mapbox.enterprise-boundaries-a5-v247.9 MB
mapbox.enterprise-boundaries-aL-v2439.7 MB
mapbox.enterprise-boundaries-p1-v288.3 MB
mapbox.enterprise-boundaries-p2-v2159.4 MB
mapbox.enterprise-boundaries-p3-v2873.6 MB
mapbox.enterprise-boundaries-p4-v2944.4 MB
mapbox.enterprise-boundaries-s1-v2441.8 MB
mapbox.enterprise-boundaries-s2-v2219.8 MB
mapbox.enterprise-boundaries-s3-v270.5 MB
mapbox.enterprise-boundaries-s4-v235.4 MB
Total7.01 GB

Hardware configuration

We recommend the following hardware configurations. The development configuration is appropriate for testing and evaluating Atlas, and is not recommended for production workloads.

DevelopmentProduction
2 CPU4 CPU
8 GB RAM16 GB RAM
60 GB SSD1000 GB SSD

Connectivity requirements

The Atlas installer has been specifically designed for situations in which the host server has no internet connectivity. You must run the installer's install or download command from a connected server to download required dependencies. Once the dependencies have been downloaded, they can be copied over to the host to complete the set up process.

Was this page helpful?