Mapbox Atlas

Current version: v2.7.0

  • 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
  • Ubuntu 18.04
  • Red Hat Enterprise Linux 7

* Recommended for development only

Data and Disk Size

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

Terrain-v21 GB40 GB
Streets-v7300 MB125 GB
Satellite1 GB275 GB
BoundariesNot Available15 GB
Search5 GB90 GB
Total8 GB545 GB

Hardware configuration

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


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?