Atlas

Current version: v2.8.0

  • On-premises vector tile maps
  • Offline Mapbox Studio
  • 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.

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.

Access token

Once you have added an active Atlas license to your Mapbox user account you will need to create a Mapbox token with atlas:read scope within the same Mapbox user account.

  1. Go to the Mapbox access token page.
  2. Click on + Create a token.
  3. Give the new token a name like "Atlas Server".
  4. Uncheck all the default public scopes under Public scopes.
  5. Under Secret scopes, check the ATLAS:READ scope.
  6. Click Create token.
  7. Save your new Atlas token in a secure place. Once you leave the Access Tokens page, you will not have access to this token again. Do not commit the Atlas token to GitHub or share it with anyone outside of your organization.

System requirements

Data and disk size

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

DatasetDevProductionHigh-Resolution
Terrain-v21 GB40 GB820 GB
Streets-v7300 MB125 GBNot Available
Streets-v8300 MB250 GBNot Available
Countries-v11 MB1.5 GBNot Available
Satellite1 GB225 GB2 TB
Terrain-RGB1.5 GB450 GB3.1 TB
BoundariesNot Available15 GBNot Available
Search5 GB75 GBNot Available
Navigation100 MB50 GBNot Available
Total9 GB1.2 TB6.5 TB

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.

DevelopmentProduction
2 CPU4 CPU
8 GB RAM16 GB RAM
60 GB SSD2 TB SSD

Get started

Atlas comes in two main flavors — Kubernetes (including OpenShift, EKS, and others) and Docker Compose. See Atlas for Kubernetes or Atlas for Docker Compose to get started.